Dps Certificate - Create Or Update

Service:

IoT Hub Device Provisioning Service

API Version:

2022-12-12

Carregue o certificado no serviço de provisionamento.
Adicione um novo certificado ou atualize um certificado existente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2022-12-12

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
certificateName	path	True	string	O nome da criação ou atualização do certificado.
provisioningServiceName	path	True	string	O nome do serviço de provisionamento.
resourceGroupName	path	True	string	Identificador do grupo de recursos.
subscriptionId	path	True	string	O identificador da assinatura.
api-version	query	True	string	A versão da API.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
If-Match		string	ETag do certificado. Isso é necessário para atualizar um certificado existente e ignorado ao criar um novo certificado.

Corpo da solicitação

Nome	Tipo	Description
properties	CertificateProperties	propriedades de um certificado

Respostas

Nome	Tipo	Description
200 OK	CertificateResponse	Se o certificado já existir e a atualização tiver sido bem-sucedida, a operação retornará http status código de 201 (OK).
Other Status Codes	ErrorDetails	Resposta de erro padrão.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

DPSCreateOrUpdateCertificate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2022-12-12

{
  "properties": {
    "certificate": "MA=="
  }
}

Sample Response

Status code:

200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpNs="
}

Definições

Nome	Description
CertificateProperties	A descrição de um certificado de autoridade de certificação X509.
CertificateResponse	O certificado X509.
createdByType	O tipo de identidade que criou o recurso.
ErrorDetails	Detalhes do erro.
systemData	Metadados relativos à criação e à última modificação do recurso.

CertificateProperties

A descrição de um certificado de autoridade de certificação X509.

Nome	Tipo	Description
certificate	string	representação base-64 do certificado X509 .cer arquivo ou apenas o conteúdo do arquivo .pem.
created	string	Data e hora de criação do certificado.
expiry	string	Data e hora de validade do certificado.
isVerified	boolean	Determina se o certificado foi verificado.
subject	string	O nome da entidade do certificado.
thumbprint	string	a impressão digital do certificado.
updated	string	Data e hora da última atualização do certificado.

CertificateResponse

O certificado X509.

Nome	Tipo	Description
etag	string	A marca da entidade.
id	string	O identificador do recurso.
name	string	O nome do certificado.
properties	CertificateProperties	propriedades de um certificado
systemData	systemData	Metadados relativos à criação e à última modificação do recurso.
type	string	O tipo de recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detalhes do erro.

Nome	Tipo	Description
code	integer	O código de erro.
details	string	Os detalhes do erro.
httpStatusCode	string	O código de status do HTTP.
message	string	A mensagem de erro.

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.