기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UntagResource
Amazon 리소스 이름()으로 식별되는 리소스에서 키-값 페어를 분리합니다ARN. 리소스는 사용자, 서버, 역할 및 기타 개체입니다.
이 직접 호출에서 응답이 반환되지 않습니다.
구문 요청
{
"Arn": "string
",
"TagKeys": [ "string
" ]
}
요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- Arn
-
태그가 제거될 리소스의 값입니다. Amazon 리소스 이름(ARN)은 서버, 사용자 또는 역할과 같은 특정 AWS 리소스의 식별자입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1600입니다.
Pattern:
arn:\S+
필수 여부: 예
- TagKeys
-
TagKeys 는 유형별로 리소스를 그룹화하고 검색하는 데 사용할 수 ARNs 있는 에 할당된 키-값 페어입니다. 이 메타데이터는 어떤 목적으로든 리소스에 첨부할 수 있습니다.
타입: 문자열 배열
배열 멤버: 최소수는 1개입니다. 최대 항목 수는 50개입니다.
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 128입니다.
필수 여부: 예
Response Elements
작업이 성공하면 서비스는 빈 HTTP 본문과 함께 HTTP 200개의 응답을 다시 보냅니다.
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- InternalServiceError
-
이 예외는 AWS Transfer Family 서비스에서 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
AWS Transfer Family 서비스에서 리소스를 찾을 수 없는 경우 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
AWS Transfer Family 서비스를 사용할 수 없으므로 요청이 실패했습니다.
HTTP 상태 코드: 500
예시
예
다음 예에서는 File Transfer 프로토콜이 활성화된 서버의 태그를 제거합니다.
샘플 요청
{
"Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
"TagKeys": "Europe" ]
}
예
이 예제에서는 의 한 가지 사용량을 보여줍니다 UntagResource.
샘플 응답
HTTP 200 response with an empty HTTP body.
참고
언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.