Certificate - List

Başvuru

Service:: Batch Service

API Version:: 2023-11-01.18.0

Belirtilen Hesaba eklenmiş olan tüm Sertifikaları listeler.
Uyarı: Bu işlem kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Lütfen bunun yerine Azure KeyVault Uzantısını kullanın.

GET {batchUrl}/certificates?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
batchUrl	path	True	string	Tüm Azure Batch hizmet isteklerinin temel URL'si.
api-version	query	True	string	İstemci API Sürümü.
$filter	query		string	OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-certificates. .
$select	query		string	OData $select yan tümcesi.
maxresults	query		integer int32	Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 Sertifika döndürülebilir.
timeout	query		integer int32	Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

Media Types: "application/json; odata=minimalmetadata"

Name	Gerekli	Tür	Description
client-request-id		string uuid	Çağıran tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan bir GUID biçimindedir; örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.
ocp-date		string date-time-rfc1123	İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

Yanıtlar

Name

Tür

Description

200 OK

CertificateListResult

Sertifika listesini içeren bir yanıt.

Headers

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

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

Scopes

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

Authorization

Type: apiKey
In: header

Örnekler

Certificate list

Sample Request

HTTP

GET account.region.batch.azure.com/certificates?api-version=2023-11-01.18.0

Sample Response

Status code:: 200

{
  "value": [
    {
      "thumbprint": "0123456789abcdef0123456789abcdef01234567",
      "thumbprintAlgorithm": "sha1",
      "url": "https://account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)",
      "state": "deletefailed",
      "stateTransitionTime": "2014-07-31T21:12:58.236Z",
      "previousState": "deleting",
      "previousStateTransitionTime": "2014-07-31T21:11:58.236Z",
      "publicData": "#####...",
      "deleteCertificateError": {
        "code": "PoolsReferencingCertificate",
        "message": "The specified certificate is being used by the below mentioned pool(s)",
        "values": [
          {
            "name": "Pools",
            "value": "mypool1"
          }
        ]
      }
    }
  ]
}

Tanımlar

Name	Description
BatchError	Azure Batch hizmetinden alınan bir hata yanıtı.
BatchErrorDetail	Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.
Certificate	İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.
CertificateListResult	Hesaptaki Sertifikaları listelemenin sonucu.
CertificateState	Sertifikanın durumu.
DeleteCertificateError	Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata.
ErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.
NameValuePair	Ad-değer çiftini temsil eder.

BatchError

Azure Batch hizmetinden alınan 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.
message	ErrorMessage	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
values	BatchErrorDetail[]	Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.

Name	Tür	Description
key	string	Value özelliğinin anlamını belirten tanımlayıcı.
value	string	Hata yanıtına eklenen ek bilgiler.

Certificate

İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.

Name	Tür	Description
deleteCertificateError	DeleteCertificateError	Bu Sertifikayı silmeye son denemede oluşan hata. Bu özellik yalnızca Sertifika DeleteFailed durumundaysa ayarlanır.
previousState	CertificateState	Sertifikanın önceki durumu. Sertifika ilk etkin durumundaysa bu özellik ayarlanmaz.
previousStateTransitionTime	string	Sertifikanın önceki durumuna girdiği saat. Sertifika ilk Etkin durumundaysa bu özellik ayarlanmaz.
publicData	string	Sertifikanın base-64 kodlanmış .cer dosyası olarak ortak bölümü.
state	CertificateState	Sertifikanın geçerli durumu.
stateTransitionTime	string	Sertifikanın geçerli durumuna girdiği saat.
thumbprint	string	Sertifikanın X.509 parmak izi. Bu, en fazla 40 onaltılık basamak dizisidir.
thumbprintAlgorithm	string	Parmak izini türetmek için kullanılan algoritma.
url	string	Sertifikanın URL'si.

CertificateListResult

Hesaptaki Sertifikaları listelemenin sonucu.

Name	Tür	Description
odata.nextLink	string	Sonraki sonuç kümesini almak için URL.
value	Certificate[]	Sertifika listesi.

CertificateState

Sertifikanın durumu.

Name	Tür	Description
active	string	Sertifika Havuzlar'da kullanılabilir.
deletefailed	string	Kullanıcı Sertifikanın silinmesini istedi, ancak Sertifikaya hala başvurular içeren Havuzlar var veya bir veya daha fazla Düğümde yüklü. (Sertifika Havuzdan kaldırılmışsa ancak İşlem Düğümü henüz yeniden başlatılmamışsa ikinci durum oluşabilir. İşlem Düğümleri 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.
deleting	string	Kullanıcı Sertifikanın silinmesini istedi, ancak silme işlemi henüz tamamlanmadı. Havuzları oluştururken veya güncelleştirirken Sertifikaya başvuramayın.

DeleteCertificateError

Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata.

Name	Tür	Description
code	string	Sertifika silme hatasının tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan Sertifika silme hatasını açıklayan bir ileti.
values	NameValuePair[]	Sertifika silme hatasıyla ilgili ek hata ayrıntılarının listesi. Bu liste, bu Sertifikaya başvuran etkin Havuzlar ve İşlem Düğümleri gibi ayrıntıları içerir. Ancak, sertifikaya çok sayıda kaynak başvuruda bulunursa, listede yalnızca ilk yüz tane bulunur.

ErrorMessage

Azure Batch hata yanıtında bir hata iletisi alındı.

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.

NameValuePair

Ad-değer çiftini temsil eder.

Name	Tür	Description
name	string	Ad-değer çiftindeki ad.
value	string	Ad-değer çiftindeki değer.