이 페이지에서는 Data Transfer Essentials를 사용하여 생성된 리소스를 관리하는 방법을 설명합니다.
구성 관리하기
프로젝트에서 데이터 전송 필수사항 구성을 나열하고, 구성 상태를 확인하고, 구성을 업데이트하거나 삭제할 수 있습니다.
프로젝트의 구성 나열
프로젝트의 위치에 있는 모든 구성을 나열하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs list 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs list \
--location=LOCATION
LOCATION을 구성의 리전으로 바꿉니다.
API
multicloudDataTransferConfigs.get 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전
선택적으로 requestID 쿼리 매개변수를 사용하여 API 요청을 식별합니다. 요청을 다시 시도하면 서버에서 식별자를 사용하여 이미 응답한 요청을 무시할 수 있습니다.
구성 세부정보 보기
구성에 대한 세부정보를 보려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs describe 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
CONFIGURATION_NAME: 구성의 이름LOCATION: 구성의 리전
다음 샘플 출력은 compute-engine의 트래픽이 데이터 전송 필수사항 청구에 고려될 준비가 되었음을 보여줍니다. cloud-sql 및 cloud-storage의 경우 업데이트가 대기 중입니다.
effectiveTime 값은 상태가 적용될 것으로 예상되는 시간을 나타냅니다. 이 샘플에서는 구성의 총 대상 수와 활성 상태인 대상 수도 보여줍니다.
description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
states:
- effectiveTime: 2024-12-12T08:00:00Z
state: DELETING
- cloud-storage:
states:
- effectiveTime: 2024-12-12T08:00:00Z
state: ADDING
- compute-engine:
states:
- state: ACTIVE
…
API
multicloudDataTransferConfigs.list 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 구성의 이름
다음 샘플 출력은 compute-engine의 트래픽이 데이터 전송 필수사항 청구에 고려될 준비가 되었음을 보여줍니다.
cloud-storage 및 cloud-sql의 경우 업데이트가 대기 중입니다.
effectiveTime 값은 상태가 적용될 것으로 예상되는 시간을 나타냅니다. 샘플에는 구성의 총 대상 수와 활성 상태인 대상 수도 표시됩니다.
{
"multicloudDataTransferConfig": [
{
"name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
"createTime": "2025-05-14T10:16:22.761275571Z",
"updateTime": "2025-05-14T10:16:25.872465362Z",
"etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
"description": "sample config",
"destinationsCount": 1,
"destinationsActiveCount": 1,
"services": {
"cloud-sql": {
"states": [
{
"effectiveTime": "2025-05-29T07:00:00Z",
"state": "DELETING"
}
]
},
"cloud-storage": {
"states": [
{
"effectiveTime": "2025-05-29T07:00:00Z",
"state": "ADDING"
}
]
},
"compute-engine": {
"states": [
{
"state": "ACTIVE"
}
]
}
}
}
]
}
서비스의 상태는 다음 중 하나일 수 있습니다.
ADDING: 서비스가 추가되고 있습니다.DELETING: 서비스가 삭제되는 중입니다.ACTIVE: 서비스가 Data Transfer Essentials 결제로 구성됩니다.
구성 업데이트
구성에서 서비스를 추가하거나 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs update 명령어를 사용합니다.
서비스를 지정하려면 다음 옵션 중 하나를 사용하세요.
services: 구성의 서비스를 지정된 목록으로 대체합니다.update-services: 지정된 서비스를 구성에 추가합니다.remove-services: 구성에서 지정된 서비스를 삭제합니다.clear-services: 구성에서 모든 서비스를 삭제합니다.
gcloud network-connectivity multicloud-data-transfer-configs update CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--services=SERVICE-A,... |
--update-services=SERVICE-A,... |
--remove-services=SERVICE-A,... |
--clear-services
다음을 바꿉니다.
CONFIGURATION_NAME: 업데이트하려는 구성의 이름LOCATION: 구성의 리전입니다.DESCRIPTION: 구성 및 그 목적에 대한 설명입니다.SERVICE-A,...: 구성에서 추가하거나 삭제할 서비스를 나타내는 문자열 시리즈입니다. 유효한 문자열은 지원되는 서비스 및 리전을 참고하세요.clear-services을 사용하여 구성에서 모든 서비스를 삭제합니다.
API
multicloudDataTransferConfigs.patch 메서드를 사용합니다.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
"description": "DESCRIPTION",
"services": {
"SERVICE-A",
"SERVICE-B"
}
}
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.LOCATION: 구성의 리전입니다.CONFIGURATION_NAME: 구성의 이름DESCRIPTION: 구성 및 그 목적에 대한 설명입니다.SERVICE-A: 구성에서 추가하거나 삭제할 서비스를 나타내는 문자열의 시리즈입니다. 유효한 문자열은 지원되는 서비스 및 리전을 참고하세요.
또한 업데이트 작업 중에 지정된 필드 집합이 덮어쓰이지 않도록 하려면 fieldMask 형식을 따르는 updateMask 옵션을 사용하면 됩니다.
데이터 전송 필수사항 구성 업데이트는 약 24시간 후에 적용됩니다.
구성 삭제
구성과 연결된 모든 대상을 삭제한 후에만 구성을 삭제할 수 있습니다.
구성을 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs delete 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
--location=LOCATION
API
multicloudDataTransferConfigs.delete 메서드를 사용합니다.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
전송 대상 관리
프로젝트에서 데이터 전송 필수사항 대상 유형을 나열하고, 대상 유형의 상태를 확인하고, 대상 유형을 업데이트하거나 삭제할 수 있습니다.
프로젝트의 대상 목록
프로젝트의 모든 대상을 나열하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations list 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations list \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
CONFIGURATION_NAME: 대상을 나열하려는 구성의 이름LOCATION: 구성의 리전
API
multicloudDataTransferConfigs.destinations.list 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 대상을 나열하려는 구성의 이름
대상 세부정보 보기
대상 세부정보를 보려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations describe 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
DESTINATION_NAME: 대상 이름CONFIGURATION_NAME: 대상을 보려는 구성의 이름LOCATION: 구성의 리전
다음 샘플에서는 destination1에 지정된 엔드포인트가 유효하며 effectiveTime에 표시된 시간까지 대상이 추가되고 있음을 보여줍니다.
createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
csp: aws
state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
states:
- effectiveTime: '2025-05-29T07:00:00Z'
state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…
API
multicloudDataTransferConfigs.destinations.get 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 구성의 이름DESTINATION_NAME: 대상 이름
다음 샘플 출력은 destination1에 지정된 엔드포인트가 유효하며 effectiveTime에 표시된 시간까지 대상이 추가되고 있음을 보여줍니다.
{
"destination": [
{
"name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
"createTime": "2025-05-14T10:18:16.941520739Z",
"updateTime": "2025-05-14T10:18:20.028116272Z",
"etag": "tag1",
"description": "sample destination",
"ipPrefix": "203.0.113.0/24",
"endpoints": [
{
"asn": 16509,
"csp": "aws",
"state": "VALID"
}
],
"stateTimeline": {
"states": [
{
"state": "ADDING",
"effectiveTime": "2025-05-29T07:00:00Z"
}
]
}
}
]
}
대상 상태는 다음 중 하나일 수 있습니다.
ADDING: 대상이 추가되고 있습니다.DELETING: 대상이 삭제되는 중입니다.SUSPENDING: 감사에 따라 대상이 정지됩니다.ACTIVE: 대상이 데이터 전송 필수사항 청구에 고려됩니다.SUSPENDED: 대상이 삭제되었거나 사용 약관을 위반하여 데이터 전송 필수사항 청구에 고려되지 않습니다.
엔드포인트의 경우 상태는 다음 중 하나일 수 있습니다.
VALID: ASN과 CSP 값의 조합이 유효합니다.INVALID: ASN 및 CSP 값의 조합이 유효하지 않습니다.
하나의 엔드포인트라도 상태가 VALID이면 대상이 데이터 전송 필수 기능 청구 대상이 됩니다.
모든 엔드포인트의 상태가 INVALID이면 대상이 데이터 전송 필수사항 청구에 적합하지 않은 것으로 간주됩니다. 이 경우 현재 상태가 ADDING인지 ACTIVE인지에 따라 대상의 상태가 SUSPENDING 또는 SUSPENDED로 설정됩니다. 이러한 대상으로의 트래픽은 일반 인터넷 트래픽으로 취급됩니다.
대상 업데이트
대상에는 엔드포인트가 하나 이상 있어야 하며 엔드포인트가 5개를 초과할 수 없습니다.
대상에서 엔드포인트를 추가하거나 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations update 명령어를 사용합니다.
엔드포인트를 지정하려면 다음 옵션 중 하나를 사용하세요. 동일한 명령에서 add-endpoints 또는 remove-endpoints 플래그를 여러 번 지정할 수 있습니다.
endpoints: 대상의 엔드포인트를 지정된 목록으로 바꿉니다.add-endpoints: 지정된 엔드포인트를 대상에 추가합니다.remove-endpoints: 대상에서 지정된 엔드포인트를 삭제합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations update DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--ip-prefix=IP_PREFIX \
--endpoints=asn=ASN,csp=CSP |
--add-endpoints=asn=ASN,csp=CSP |
--remove-endpoints=asn=ASN,csp=CSP
다음을 바꿉니다.
DESTINATION_NAME: 대상의 이름입니다.CONFIGURATION_NAME: 업데이트하려는 구성의 이름LOCATION: 구성의 리전입니다.DESCRIPTION: 대상 및 그 목적에 대한 설명입니다.IP_PREFIX: 범위 또는 값으로 지정된 대상의 IP 접두사입니다.각 엔드포인트에 대해 다음을 지정합니다.
ASN: 프리픽스를 공지할 것으로 예상되는 ASN입니다. 인식된 ASN을 참고하세요.CSP: 프리픽스를 알리는 ASN의 CSP를 나타내는 문자열입니다.
API
multicloudDataTransferConfigs.destinations.patch 메서드를 사용합니다.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
"description": "DESCRIPTION",
"ip_prefix": "IP_PREFIX",
"endpoints": [
{
"asn": "ASN",
"csp": "CSP"
}
]
}
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.LOCATION: 구성의 리전입니다.CONFIGURATION_NAME: 구성의 이름DESTINATION_NAME: 대상의 이름입니다.DESCRIPTION: 대상 및 그 목적에 대한 설명입니다.IP_PREFIX: 범위 (예:203.0.113.0/24또는2001:db8::/32) 또는 값 (예:203.0.113.6또는2001:db8:2:2:2:2:2:2)으로 지정된 대상의 IP 접두사입니다. IP 접두사는 구성에서 한 번만 사용해야 하며 하나의 ASN에만 사용해야 합니다.대상에 추가할 엔드포인트에 해당하는 문자열을 지정하거나 대상에 유지하지 않을 엔드포인트를 삭제합니다.
ASN: 프리픽스를 공지할 것으로 예상되는 ASN입니다. 인식된 ASN을 참고하세요.CSP: 프리픽스를 알리는 ASN의 CSP를 나타내는 문자열입니다.
또한 업데이트 작업 중에 지정된 필드 집합이 덮어쓰이지 않도록 하려면 fieldMask 형식을 따르는 updateMask 옵션을 사용하면 됩니다.
데이터 전송 필수사항 도착 페이지 및 관련 구성 업데이트는 약 24시간 후에 적용됩니다.
대상 삭제
대상을 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations delete 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
API
multicloudDataTransferConfigs.destinations.delete 메서드를 사용합니다.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME