Certificate - List By Service
Lista uma coleção de todos os certificados na instância de serviço especificada.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates?$filter={$filter}&$top={$top}&$skip={$skip}&isKeyVaultRefreshFailed={isKeyVaultRefreshFailed}&api-version=2022-08-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas. |
service
|
path | True |
string |
O nome do serviço Gestão de API. Regex pattern: |
subscription
|
path | True |
string |
O ID da subscrição de destino. |
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
$filter
|
query |
string |
| Campo | Utilização | Operadores suportados | Funções suportadas | |
|
$skip
|
query |
integer int32 |
Número de registos a ignorar. |
|
$top
|
query |
integer int32 |
Número de registos a devolver. |
|
is
|
query |
boolean |
Quando definida como verdadeira, a resposta contém apenas entidades de certificados que falharam na atualização. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Devolve uma coleção da entidade Certificado. |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
ApiManagementListCertificates
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates?api-version=2022-08-01
Sample Response
{
"value": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/kjoshiarmtemplateCert1",
"type": "Microsoft.ApiManagement/service/certificates",
"name": "templateCert1",
"properties": {
"subject": "CN=mutual-authcert",
"thumbprint": "EBA************************48594A6",
"expirationDate": "2017-04-23T17:03:41Z"
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCertkv",
"type": "Microsoft.ApiManagement/service/certificates",
"name": "templateCertkv",
"properties": {
"subject": "CN=*.msitesting.net",
"thumbprint": "EA**********************9AD690",
"expirationDate": "2037-01-01T07:00:00Z",
"keyVault": {
"secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
"identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
"lastStatus": {
"code": "Success",
"timeStampUtc": "2020-09-22T00:24:53.3191468Z"
}
}
}
}
],
"count": 2,
"nextLink": ""
}
Definições
Name | Description |
---|---|
Certificate |
Representação da lista de Certificados Paginados. |
Certificate |
Detalhes do certificado. |
Error |
Contrato de campo de erro. |
Error |
Resposta a Erros. |
Key |
Detalhes do contrato do KeyVault. |
Key |
Emitir propriedades de atualização do contrato. |
CertificateCollection
Representação da lista de Certificados Paginados.
Name | Tipo | Description |
---|---|---|
count |
integer |
Número total de contagem de registos em todas as páginas. |
nextLink |
string |
Ligação da página seguinte, se existir. |
value |
Valores de página. |
CertificateContract
Detalhes do certificado.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties.expirationDate |
string |
Data de expiração do certificado. A data está em conformidade com o seguinte formato: |
properties.keyVault |
Detalhes da localização do KeyVault do certificado. |
|
properties.subject |
string |
Atributo assunto do certificado. |
properties.thumbprint |
string |
Impressão digital do certificado. |
type |
string |
O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ErrorFieldContract
Contrato de campo de erro.
Name | Tipo | Description |
---|---|---|
code |
string |
Código de erro ao nível da propriedade. |
message |
string |
Representação legível por humanos do erro ao nível da propriedade. |
target |
string |
Nome da propriedade. |
ErrorResponse
Resposta a Erros.
Name | Tipo | Description |
---|---|---|
error.code |
string |
Código de erro definido pelo serviço. Este código serve como um sub-estado para o código de erro HTTP especificado na resposta. |
error.details |
A lista de campos inválidos enviados a pedido, em caso de erro de validação. |
|
error.message |
string |
Representação legível por humanos do erro. |
KeyVaultContractProperties
Detalhes do contrato do KeyVault.
Name | Tipo | Description |
---|---|---|
identityClientId |
string |
Null para SystemAssignedIdentity ou ID de Cliente para UserAssignedIdentity , que será utilizado para aceder ao segredo do cofre de chaves. |
lastStatus |
Da última vez, sincronize e atualize o estado do segredo do cofre de chaves. |
|
secretIdentifier |
string |
Identificador do segredo do cofre de chaves para obter o segredo. Fornecer um segredo com versões impedirá a atualização automática. Isto requer que Gestão de API serviço seja configurado com aka.ms/apimmsi |
KeyVaultLastAccessStatusContractProperties
Emitir propriedades de atualização do contrato.
Name | Tipo | Description |
---|---|---|
code |
string |
Último código de estado para sincronização e atualização do segredo do cofre de chaves. |
message |
string |
Os detalhes do erro estão vazios. |
timeStampUtc |
string |
A última vez que o segredo foi acedido. A data está em conformidade com o seguinte formato: |