Certificate - Get

Hizmet:: Batch Management

API Sürümü:: 2024-07-01

Belirtilen sertifika hakkında bilgi alır.
Uyarı: Bu işlem kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Bunun yerine Azure KeyVault Uzantısı kullanın.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates/{certificateName}?api-version=2024-07-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-zA-Z0-9]+$	Bölgede benzersiz olması gereken Batch hesabı için bir isim. Toplu hesap isimleri 3 ile 24 karakter arasında uzun olmalı ve yalnızca numaralar ile küçük harfler kullanılmalıdır. Bu isim, hesabın oluşturulduğu bölgedeki Batch hizmetine erişmek için kullanılan DNS adının bir parçası olarak kullanılır. Örneğin: `http://accountname.region.batch.azure.com/`.
certificateName	path	True	string minLength: 5 maxLength: 45 pattern: ^[\w]+-[\w]+$	Sertifikanın tanımlayıcısı. Bu, bir tireyle ayrılmış algoritma ve parmak izinden oluşturulmalıdır ve istekteki sertifika verileriyle eşleşmelidir. Örneğin SHA1-a3d1c5.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Certificate	İstek başarılı oldu. Üst Bilgiler ETag: string
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

Certificate

İstek başarılı oldu.

Üst Bilgiler

ETag: string

Other Status Codes

CloudError

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get Certificate

Get Certificate with Deletion Error

Get Certificate

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

Örnek yanıt

Durum kodu:: 200

ETag: W/"0x8D4EDD5118668F7"

{
  "name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
  "type": "Microsoft.Batch/batchAccounts/certificates",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
  "properties": {
    "format": "Pfx",
    "provisioningState": "Succeeded",
    "provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
    "publicData": "MIICrjCCAZagAwI...",
    "thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
    "thumbprintAlgorithm": "sha1"
  }
}

Get Certificate with Deletion Error

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

Örnek yanıt

Durum kodu:: 200

ETag: W/"0x8D4EDD5118668F7"

{
  "name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
  "type": "Microsoft.Batch/batchAccounts/certificates",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
  "properties": {
    "format": "Pfx",
    "deleteCertificateError": {
      "code": "NodesReferencingCertificate",
      "message": "The specified certificate is being used by the below mentioned node(s)\nRequestId:2dc78afc-b15b-42d2-8c85-39cb61a0799e\nTime:2017-08-28T10:22:52.8633406Z",
      "target": "BatchAccount",
      "details": [
        {
          "code": "Nodes",
          "message": "node1, node3"
        }
      ]
    },
    "previousProvisioningState": "Deleting",
    "previousProvisioningStateTransitionTime": "2017-07-21T00:15:25.5625498Z",
    "provisioningState": "Failed",
    "provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
    "publicData": "MIICrjCCAZagAwI...",
    "thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
    "thumbprintAlgorithm": "sha1"
  }
}

Tanımlar

Name	Description
Certificate	Sertifika hakkında bilgi içerir.
CertificateFormat	Sertifikanın biçimi : Pfx veya Cer. Atlanırsa, varsayılan değer Pfx'tir.
CertificateProvisioningState	Sertifikanın mevcut tedarik durumu.
CloudError	Batch hizmetinden bir hata yanıtı.
CloudErrorBody	Batch hizmetinden bir hata yanıtı.
createdByType	Kaynağı oluşturan kimliğin türü.
DeleteCertificateError	Batch hizmetinden bir hata yanıtı.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Certificate

Nesne

Sertifika hakkında bilgi içerir.

Name	Tür	Description
etag	string	Eşzamanlılık deyimleri için kullanılan kaynağın ETag'i.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.deleteCertificateError	DeleteCertificateError	Sertifika silinirken oluşan hata Bu yalnızca certificate provisioningState değeri 'Failed' olduğunda döndürülür.
properties.format	CertificateFormat	Sertifikanın biçimi : Pfx veya Cer. Atlanırsa, varsayılan değer Pfx'tir.
properties.previousProvisioningState	CertificateProvisioningState	Kaynağın önceki sağlanmış durumu
properties.previousProvisioningStateTransitionTime	string (date-time)	Sertifikanın önceki durumuna girdiği saat. Sertifikanın önceki durumuna girdiği saat.
properties.provisioningState	CertificateProvisioningState	Kaynağın sağlanan durumu Kaynağın sağlanan durumu
properties.provisioningStateTransitionTime	string (date-time)	Sertifikanın geçerli durumuna girdiği saat. Sertifikanın geçerli durumuna girdiği saat.
properties.publicData	string	Sertifikanın ortak anahtarı.
properties.thumbprint	string	Sertifikanın parmak izi. Bu, adın parmak iziyle eşleşmelidir.
properties.thumbprintAlgorithm	string	Sertifika parmak izi algoritması. Bu, sertifika adının ilk bölümüyle eşleşmelidir. Şu anda 'SHA1' olması gerekir.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynağın etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

CertificateFormat

Numaralandırma

Sertifikanın biçimi : Pfx veya Cer. Atlanırsa, varsayılan değer Pfx'tir.

Değer	Description
Pfx	Sertifika, PFX (PKCS#12) biçimli bir sertifika veya sertifika zinciridir.
Cer	Sertifika, base64 kodlu bir X.509 sertifikasıdır.

CertificateProvisioningState

Numaralandırma

Sertifikanın mevcut tedarik durumu.

Değer	Description
Succeeded	Sertifika havuzlarda kullanılabilir.
Deleting	Kullanıcı sertifikanın silinmesini istedi, ancak silme işlemi henüz tamamlanmadı. Havuz oluştururken veya güncelleştirirken sertifikaya başvuramayasınız.
Failed	Kullanıcı sertifikanın silinmesini istedi, ancak sertifikaya hala başvurular içeren havuzlar var veya hala bir veya daha fazla işlem düğümünde yüklü. (Sertifika havuzdan kaldırıldıysa ancak düğüm henüz yeniden başlatılmadıysa, ikincisi oluşabilir. Düğümler sertifikalarını yalnızca yeniden başlattıklarında yeniler.) Silme işlemini iptal etmek için sertifika silme işlemini veya silmeyi yeniden denemek için sertifika silme işlemini kullanabilirsiniz.

CloudError

Nesne

Batch hizmetinden bir hata yanıtı.

Name	Tür	Description
error	CloudErrorBody	Hata yanıtının gövdesi.

CloudErrorBody

Nesne

Batch hizmetinden bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
details	CloudErrorBody[]	Hatayla ilgili ek ayrıntıların listesi.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
target	string	Belirli bir hatanın hedefi. Örneğin, özelliğin adı hatalı.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DeleteCertificateError

Nesne

Batch hizmetinden bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
details	DeleteCertificateError[]	Hatayla ilgili ek ayrıntıların listesi.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
target	string	Belirli bir hatanın hedefi. Örneğin, özelliğin adı hatalı.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.