Compartir a través de


App Service Certificate Orders - Get

Descripción para Obtener un pedido de certificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}?api-version=2024-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
certificateOrderName
path True

string

Nombre del pedido de certificado.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+[^\.]$

Nombre del grupo de recursos al que pertenece el recurso.

subscriptionId
path True

string

Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-00000-0000-0000-00000000000000).

api-version
query True

string

Versión de la API

Respuestas

Nombre Tipo Description
200 OK

AppServiceCertificateOrder

De acuerdo

Other Status Codes

DefaultErrorResponse

Respuesta de error de App Service.

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

Get App Service Certificate Order

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.CertificateRegistration/certificateOrders/SampleCertificateOrderName?api-version=2024-11-01

Respuesta de muestra

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.CertificateRegistration/certificateOrders/SampleCertificateOrderName",
  "name": "SampleCertificateOrderName",
  "type": "Microsoft.CertificateRegistration/certificateOrders",
  "location": "Global",
  "properties": {
    "certificates": {
      "SampleCertName1": {
        "keyVaultId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/microsoft.keyvault/vaults/SamplevaultName",
        "keyVaultSecretName": "SampleSecretName1",
        "provisioningState": "Succeeded"
      },
      "SampleCertName2": {
        "keyVaultId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/microsoft.keyvault/vaults/SamplevaultName",
        "keyVaultSecretName": "SampleSecretName2",
        "provisioningState": "KeyVaultSecretDoesNotExist"
      }
    },
    "distinguishedName": "CN=SampleCustomDomain.com",
    "domainVerificationToken": "awe4163Br6d32r",
    "validityInYears": 2,
    "keySize": 2048,
    "productType": "StandardDomainValidatedSsl",
    "autoRenew": true,
    "provisioningState": "Succeeded",
    "status": "Issued",
    "signedCertificate": {
      "version": 1232490,
      "serialNumber": "sds12424k",
      "thumbprint": "FE703D7411A44163B6D32B3AD9B03E175886EBFE",
      "subject": "CN=CertSubjectName",
      "issuer": "CACert",
      "signatureAlgorithm": "SHA",
      "notAfter": "2022-11-12T23:40:25+00:00",
      "notBefore": "2021-11-12T23:40:25+00:00"
    },
    "csr": "xdf!x|",
    "intermediate": {
      "version": 5589220,
      "serialNumber": "k45kad0024",
      "thumbprint": "RF3D7411A44163B6D32B3343559B03E175886EBFE",
      "subject": "CN=IntermediateCertSubjectName",
      "issuer": "CACert",
      "signatureAlgorithm": "SHA",
      "notAfter": "2023-11-12T23:40:25+00:00",
      "notBefore": "2021-05-12T23:40:25+00:00"
    },
    "root": {
      "version": 3430921,
      "serialNumber": "jkskd890ajdd00124",
      "thumbprint": "ZD3D7411A44163B6D32B3343559B03E175886EBFE",
      "subject": "CN=RootCertSubjectName",
      "issuer": "CACert",
      "signatureAlgorithm": "SHA",
      "notAfter": "2023-11-12T23:40:25+00:00",
      "notBefore": "2021-05-12T23:40:25+00:00"
    },
    "serialNumber": "12324325325",
    "lastCertificateIssuanceTime": "2021-11-12T23:40:25+00:00",
    "expirationTime": "2022-11-12T23:40:25+00:00",
    "isPrivateKeyExternal": false,
    "appServiceCertificateNotRenewableReasons": [
      "ExpirationNotInRenewalTimeRange"
    ],
    "nextAutoRenewalTimeStamp": "2022-11-12T23:40:25+00:00",
    "contact": {
      "email": "contact@email.com",
      "nameFirst": "SampleFirstName",
      "nameLast": "SampleLastName",
      "phone": "1-224-550-332"
    }
  }
}

Definiciones

Nombre Description
AppServiceCertificate

Contenedor de Key Vault para un certificado que se adquiere a través de Azure.

AppServiceCertificateOrder

Pedido de compra del certificado SSL.

CertificateDetails

Detalles del certificado SSL.

CertificateOrderContact
CertificateOrderStatus

Estado del pedido actual.

CertificateProductType

Tipo de producto de certificado.

DefaultErrorResponse

Respuesta de error de App Service.

Details
Error

Modelo de error.

KeyVaultSecretStatus

Estado del secreto de Key Vault.

ProvisioningState

Estado del pedido de certificado.

ResourceNotRenewableReason

Motivos por los que App Service Certificate no es renovable en el momento actual.

AppServiceCertificate

Contenedor de Key Vault para un certificado que se adquiere a través de Azure.

Nombre Tipo Description
keyVaultId

string

Id. de recurso de Key Vault.

keyVaultSecretName

string

Nombre del secreto de Key Vault.

provisioningState

KeyVaultSecretStatus

Estado del secreto de Key Vault.

AppServiceCertificateOrder

Pedido de compra del certificado SSL.

Nombre Tipo Valor predeterminado Description
id

string

Identificador de recurso.

kind

string

Tipo de recurso. Si el recurso es una aplicación, puede consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obtener más información sobre los valores admitidos para el tipo.

location

string

Ubicación del recurso.

name

string

Nombre del recurso.

properties.appServiceCertificateNotRenewableReasons

ResourceNotRenewableReason[]

Motivos por los que App Service Certificate no es renovable en el momento actual.

properties.autoRenew

boolean

True

true si el certificado debe renovarse automáticamente cuando expire; de lo contrario, false.

properties.certificates

<string,  AppServiceCertificate>

Estado del secreto de Key Vault.

properties.contact

CertificateOrderContact

Información de contacto

properties.csr

string

Última CSR que se creó para este pedido.

properties.distinguishedName

string

Nombre distintivo del certificado.

properties.domainVerificationToken

string

Token de comprobación de dominio.

properties.expirationTime

string (date-time)

Hora de expiración del certificado.

properties.intermediate

CertificateDetails

Certificado intermedio.

properties.isPrivateKeyExternal

boolean

true si la clave privada es externa; de lo contrario, false.

properties.keySize

integer (int32)

2048

Tamaño de clave de certificado.

properties.lastCertificateIssuanceTime

string (date-time)

Hora de la última emisión del certificado.

properties.nextAutoRenewalTimeStamp

string (date-time)

Marca de tiempo en la que el certificado se renovaría automáticamente a continuación

properties.productType

CertificateProductType

Tipo de producto de certificado.

properties.provisioningState

ProvisioningState

Estado del pedido de certificado.

properties.root

CertificateDetails

Certificado raíz.

properties.serialNumber

string

Número de serie actual del certificado.

properties.signedCertificate

CertificateDetails

Certificado firmado.

properties.status

CertificateOrderStatus

Estado del pedido actual.

properties.validityInYears

integer (int32)

1

Duración en años (debe ser 1).

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

CertificateDetails

Detalles del certificado SSL.

Nombre Tipo Description
issuer

string

Emisor de certificados.

notAfter

string (date-time)

El certificado de fecha es válido para.

notBefore

string (date-time)

El certificado de fecha es válido desde.

rawData

string

Datos de certificado sin procesar.

serialNumber

string

Número de serie del certificado.

signatureAlgorithm

string

Algoritmo de firma de certificado.

subject

string

Asunto del certificado.

thumbprint

string

Huella digital del certificado.

version

integer (int32)

Versión del certificado.

CertificateOrderContact

Nombre Tipo Description
email

string

nameFirst

string

nameLast

string

phone

string

CertificateOrderStatus

Estado del pedido actual.

Valor Description
Canceled
Denied
Expired
Issued
NotSubmitted
PendingRekey
Pendingissuance
Pendingrevocation
Revoked
Unused

CertificateProductType

Tipo de producto de certificado.

Valor Description
StandardDomainValidatedSsl
StandardDomainValidatedWildCardSsl

DefaultErrorResponse

Respuesta de error de App Service.

Nombre Tipo Description
error

Error

Modelo de error.

Details

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

Error

Modelo de error.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

details

Details[]

Errores detallados.

innererror

string

Más información para depurar el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

KeyVaultSecretStatus

Estado del secreto de Key Vault.

Valor Description
AzureServiceUnauthorizedToAccessKeyVault
CertificateOrderFailed
ExternalPrivateKey
Initialized
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
OperationNotPermittedOnKeyVault
Succeeded
Unknown
UnknownError
WaitingOnCertificateOrder

ProvisioningState

Estado del pedido de certificado.

Valor Description
Canceled
Deleting
Failed
InProgress
Succeeded

ResourceNotRenewableReason

Motivos por los que App Service Certificate no es renovable en el momento actual.

Valor Description
ExpirationNotInRenewalTimeRange
RegistrationStatusNotSupportedForRenewal
SubscriptionNotActive