Compartir a través de


Product Group Link - List By Product

Enumera una colección de los vínculos de grupo asociados a un producto.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
productId
path True

string

minLength: 1
maxLength: 256

Identificador del producto. Debe ser único en la instancia actual del servicio API Management.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

serviceName
path True

string

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

Nombre del servicio API Management.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

$filter
query

string

| Campo | Uso | Operadores admitidos | Funciones admitidas |
|-------------|-------------|-------------|-------------|
| groupId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |

$skip
query

integer (int32)

minimum: 0

Número de registros que se van a omitir.

$top
query

integer (int32)

minimum: 1

Número de registros que se van a devolver.

Respuestas

Nombre Tipo Description
200 OK

ProductGroupLinkCollection

El cuerpo de la respuesta contiene una colección de entidades de vínculo de grupo en el producto.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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": ""
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ProductGroupLinkCollection

Representación de la lista de vínculos de grupo de productos paginado.

ProductGroupLinkContract

Detalles del vínculo del grupo de productos.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ProductGroupLinkCollection

Representación de la lista de vínculos de grupo de productos paginado.

Nombre Tipo Description
count

integer (int64)

Número total de recuento de registros en todas las páginas.

nextLink

string

Vínculo de página siguiente si existe.

value

ProductGroupLinkContract[]

Valores de página.

ProductGroupLinkContract

Detalles del vínculo del grupo de productos.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso

properties.groupId

string

Identificador de recurso completo de un grupo.

type

string

Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"