Certificates - Create Or Update

Reference

Service:: IoT Hub

API Version:: 2018-04-01

Nahrajte certifikát do centra IoT.
Přidá nový nebo nahradí existující certifikát.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName}?api-version=2018-04-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
certificateName	path	True	string	Název certifikátu Regex pattern: `^[A-Za-z0-9-._]{1,64}$`
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje centrum IoT.
resourceName	path	True	string	Název centra IoT.
subscriptionId	path	True	string	Identifikátor předplatného.
api-version	query	True	string	Verze rozhraní API.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match		string	ETag certifikátu. Nezadávejte pro vytvoření zcela nového certifikátu. Vyžaduje se k aktualizaci existujícího certifikátu.

Text požadavku

Name	Typ	Description
certificate	string	Base-64 reprezentace certifikátu X509 typu list .cer souboru nebo pouze obsahu souboru .pem.

Odpovědi

Name	Typ	Description
200 OK	CertificateDescription	Pokud certifikát již existuje a aktualizace proběhla úspěšně, operace vrátí stavový kód HTTP 201 (OK).
201 Created	CertificateDescription	Pokud certifikát neexistoval, vytvoření proběhlo úspěšně, operace vrátí stavový kód HTTP 201 (OK).
Other Status Codes	ErrorDetails	DefaultErrorResponse

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Certificates_CreateOrUpdate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/iothub/certificates/cert?api-version=2018-04-01

{
  "certificate": "############################################"
}

Sample Response

Status code:: 201

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "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/IotHubs/Certificates",
  "etag": "AAAAAAExpNs="
}

Status code:: 200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "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/IotHubs/Certificates",
  "etag": "AAAAAAExpNs="
}

Definice

Name	Description
CertificateBodyDescription	Certifikát X509 serializovaný ve formátu JSON.
CertificateDescription	Certifikát X509.
CertificateProperties	Popis certifikátu certifikační autority X509.
ErrorDetails	Podrobnosti o chybě.

CertificateBodyDescription

Certifikát X509 serializovaný ve formátu JSON.

Name	Typ	Description
certificate	string	Base-64 reprezentace certifikátu X509 typu list .cer souboru nebo pouze obsahu souboru .pem.

CertificateDescription

Certifikát X509.

Name	Typ	Description
etag	string	Značka entity.
id	string	Identifikátor prostředku.
name	string	Název certifikátu.
properties	CertificateProperties	Popis certifikátu certifikační autority X509.
type	string	Typ prostředku.

CertificateProperties

Popis certifikátu certifikační autority X509.

Name	Typ	Description
certificate	string	Obsah certifikátu
created	string	Datum a čas vytvoření certifikátu
expiry	string	Datum a čas vypršení platnosti certifikátu.
isVerified	boolean	Určuje, jestli byl certifikát ověřen.
subject	string	Název subjektu certifikátu.
thumbprint	string	Kryptografický otisk certifikátu
updated	string	Datum a čas poslední aktualizace certifikátu.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
details	string	Podrobnosti o chybě.
httpStatusCode	string	Stavový kód HTTP
message	string	Chybová zpráva