Certificate - List

Başvuru

Hizmet:: Batch Service

API Sürümü:: 2024-07-01.20.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. Bunun yerine Azure KeyVault Uzantısı kullanın.

GET {batchUrl}/certificates?api-version=2024-07-01.20.0

İsteğe bağlı parametrelerle:

GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.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://learn.microsoft.com/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 cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name	Gerekli	Tür	Description
client-request-id		string uuid	Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, ö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

Sertifikalar listesini içeren bir yanıt.

Üst Bilgiler

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

Other Status Codes

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

Microsoft Entra OAuth 2.0 kimlik doğrulama kodu 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

Authorization

Tür: apiKey
İçinde: header

Örnekler

Certificate list

Örnek isteği

HTTP

GET account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0

Örnek yanıt

Durum kodu:: 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 dahil edilen 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[]	Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına dahil edilen 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[]	Sertifikalar 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şvuruda bulunan havuzlar var veya bir veya daha fazla Düğümde yüklü. (Sertifika Havuzdan kaldırıldıysa ancak İşlem Düğümü henüz yeniden başlatılmadıysa, ikincisi oluşabilir. İşlem Düğümleri sertifikalarını yalnızca yeniden başlatıldığı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şvuramayasınız.

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 kaynak 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.