Dps Certificate - Create Or Update

Referensi

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Unggah sertifikat ke layanan provisi.
Tambahkan sertifikat baru atau perbarui sertifikat yang sudah ada.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
certificateName	path	True	string	Nama sertifikat yang dibuat atau diperbarui.
provisioningServiceName	path	True	string	Nama layanan provisi.
resourceGroupName	path	True	string	Pengidentifikasi grup sumber daya.
subscriptionId	path	True	string	Pengidentifikasi langganan.
api-version	query	True	string	Versi API.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match		string	ETag sertifikat. Ini diperlukan untuk memperbarui sertifikat yang ada, dan diabaikan saat membuat sertifikat baru.

Isi Permintaan

Nama	Jenis	Deskripsi
properties	CertificateProperties	properti sertifikat

Respons

Nama	Jenis	Deskripsi
200 OK	CertificateResponse	Jika sertifikat sudah ada dan pembaruan berhasil, operasi mengembalikan kode status HTTP 201 (OK).
Other Status Codes	ErrorDetails	Respons kesalahan default.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

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

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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="
}

Definisi

Nama	Deskripsi
CertificateProperties	Penjabaran dari Sertifikat CA X509.
CertificateResponse	Sertifikat X509.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorDetails	Detail kesalahan.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CertificateProperties

Penjabaran dari Sertifikat CA X509.

Nama	Jenis	Deskripsi
certificate	string	representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.
created	string	Tanggal dan waktu pembuatan sertifikat.
expiry	string	Tanggal dan waktu kedaluwarsa sertifikat.
isVerified	boolean	Menentukan apakah sertifikat telah diverifikasi.
subject	string	Nama subjek sertifikat.
thumbprint	string	Thumbprint sertifikat.
updated	string	Tanggal dan waktu pembaruan terakhir sertifikat.

CertificateResponse

Sertifikat X509.

Nama	Jenis	Deskripsi
etag	string	Tag entitas.
id	string	Pengidentifikasi sumber daya.
name	string	Nama sertifikat.
properties	CertificateProperties	properti sertifikat
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type	string	Jenis sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detail kesalahan.

Nama	Jenis	Deskripsi
code	integer	Kode kesalahan.
details	string	Detail kesalahan.
httpStatusCode	string	Kode status HTTP.
message	string	Pesan kesalahan.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir memodifikasi sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah sumber daya.

Share via