Compartir a través de


Gateway Certificate Authority - List By Service

Enumera la colección de entidades de certificación para la entidad de puerta de enlace especificada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/certificateAuthorities?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/certificateAuthorities?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2022-08-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
gatewayId
path True

string

Identificador de entidad de puerta de enlace. Debe ser único en la instancia de servicio de API Management actual. No debe tener el valor "administrado".

resourceGroupName
path True

string

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

serviceName
path True

string

Nombre del servicio API Management.

Patrón de Regex: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

$filter
query

string

| Campo | Uso | Operadores admitidos | Funciones admitidas |
|-------------|-------------|-------------|-------------|
| name | filter | eq, ne | |

$skip
query

integer

int32

Número de registros que se van a omitir.

$top
query

integer

int32

Número de registros que se va a devolver.

Respuestas

Nombre Tipo Description
200 OK

GatewayCertificateAuthorityCollection

Colección de entidades de entidad de certificación de puerta de enlace.

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de 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 suplantación de su cuenta de usuario

Ejemplos

ApiManagementListGatewaycertificateAuthorities

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/certificateAuthorities?api-version=2022-08-01

Respuesta de muestra

{
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/certificateAuthorities/cert1",
      "type": "Microsoft.ApiManagement/service/gateways/certificateAuthorities",
      "name": "cert1",
      "properties": {
        "isTrusted": false
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/certificateAuthorities/cert2",
      "type": "Microsoft.ApiManagement/service/gateways/certificateAuthorities",
      "name": "cert2",
      "properties": {
        "isTrusted": true
      }
    }
  ],
  "nextLink": ""
}

Definiciones

Nombre Description
ErrorFieldContract

Contrato de campo de error.

ErrorResponse

Respuesta de error.

GatewayCertificateAuthorityCollection

Representación de la lista de entidades de certificación de puerta de enlace paginada.

GatewayCertificateAuthorityContract

Detalles de la entidad de certificación de puerta de enlace.

ErrorFieldContract

Contrato de campo de error.

Nombre Tipo Description
code

string

Código de error de nivel de propiedad.

message

string

Representación legible del error de nivel de propiedad.

target

string

Nombre de propiedad.

ErrorResponse

Respuesta de error.

Nombre Tipo Description
error.code

string

Código del error definido por el servicio. Este código funciona como estado secundario del código de error HTTP especificado en la respuesta.

error.details

ErrorFieldContract[]

La lista de campos no válidos que se envían en la solicitud, en caso de error de validación.

error.message

string

Representación legible del error.

GatewayCertificateAuthorityCollection

Representación de la lista de entidades de certificación de puerta de enlace paginada.

Nombre Tipo Description
nextLink

string

Vínculo de página siguiente, si existe.

value

GatewayCertificateAuthorityContract[]

Valores de página.

GatewayCertificateAuthorityContract

Detalles de la entidad de certificación de puerta de enlace.

Nombre Tipo Description
id

string

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

name

string

Nombre del recurso.

properties.isTrusted

boolean

Determina si la entidad de certificación es de confianza.

type

string

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