원하는 IP 주소에 대한 고유 식별자를 사용하여 하나의 글로벌 액세스 목록 항목의 값을 업데이트합니다.
특정 글로벌 액세스 목록 항목을 찾으려면 글로벌 액세스 목록 항목 목록 을 가져온 다음 필요한 {ACCESS-LIST-ID}
를 찾습니다.
기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
PATCH /admin/accessList/{ACCESS-LIST-ID}
필수 역할
이 엔드포인트를 호출하는 API 키에 Global Owner
역할이 있어야 합니다.
요청 매개변수
요청 경로 매개변수
이름 | 유형 | 설명 |
---|---|---|
| 문자열 | 글로벌 액세스 목록 항목의 고유 식별자입니다. |
요청 쿼리 매개변수
다음 쿼리 매개변수는 선택 사항입니다.
이름 | 유형 | 필요성 | 설명 | 기본값 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 부울 | 옵션 | 응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다. |
| ||||||
envelope | 부울 | 옵션 | 응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.
|
|
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
이름 | 유형 | 설명 |
---|---|---|
| 문자열 | IPv4 또는 IPv6 CIDR 표기법으로 표시된 액세스 목록의 IP 주소 범위입니다. |
| 문자열 | 타임스탬프(글로벌 액세스 목록에 이 CIDR 차단 추가한 UNIX 에포크 이후 경과된 시간(초))입니다. |
| 문자열 | 이 글로벌 액세스 목록 항목의 목적에 대한 설명입니다. |
| 문자열 | 이 글로벌 액세스 목록 항목의 고유 식별자입니다. |
| 문자열 | 글로벌 액세스 목록 항목의 범위. |
| 문자열 | 이 글로벌 액세스 목록 항목의 CIDR차단 마지막으로 변경한 UNIX 에포크 이후 경과된 시간(초)으로 표시한 타임스탬프입니다. |
요청 예시
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList/{ACCESS-LIST-ID}?pretty=true"
응답 예시
응답 헤더
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
응답 본문
1 { 2 "cidrBlock" : "127.0.0.1/32", 3 "created" : "2019-09-04T17:45:33Z", 4 "description" : "Docs Example", 5 "expires" : null, 6 "id" : "{ACCESS-LIST-ID}", 7 "lastUsed" : null, 8 "type" : "GLOBAL_ROLE", 9 "updated" : "2019-09-04T17:45:33Z" 10 }