다음을 통해 공유


Product Group Link - List By Product

제품과 연결된 그룹 링크의 컬렉션을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groupLinks?api-version=2024-05-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groupLinks?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2024-05-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
productId
path True

string

minLength: 1
maxLength: 256

제품 식별자입니다. 현재 API Management 서비스 인스턴스에서 고유해야 합니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

serviceName
path True

string

minLength: 1
maxLength: 50
pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

API Management 서비스의 이름입니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

$filter
query

string

| 필드 | 사용량 | 지원되는 연산자 | 지원되는 함수 |
|-------------|-------------|-------------|-------------|
| groupId | 필터 | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |

$skip
query

integer (int32)

minimum: 0

건너뛸 레코드 수입니다.

$top
query

integer (int32)

minimum: 1

반환할 레코드 수입니다.

응답

Name 형식 Description
200 OK

ProductGroupLinkCollection

응답 본문에는 제품의 그룹 링크 엔터티 컬렉션이 포함되어 있습니다.

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/product1/groupLinks?api-version=2024-05-01

샘플 응답

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/product1/groupLinks/link1",
      "type": "Microsoft.ApiManagement/service/products/groupLinks",
      "name": "link1",
      "properties": {
        "groupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/group1"
      }
    }
  ],
  "count": 1,
  "nextLink": ""
}

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

ProductGroupLinkCollection

페이징된 제품 그룹 링크 목록 표현입니다.

ProductGroupLinkContract

제품 그룹 링크 세부 정보입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ProductGroupLinkCollection

페이징된 제품 그룹 링크 목록 표현입니다.

Name 형식 Description
count

integer (int64)

모든 페이지의 총 레코드 수 수입니다.

nextLink

string

다음 페이지 링크(있는 경우)입니다.

value

ProductGroupLinkContract[]

페이지 값입니다.

ProductGroupLinkContract

제품 그룹 링크 세부 정보입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

리소스의 이름

properties.groupId

string

그룹의 전체 리소스 ID입니다.

type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"