API standartları ve çok dilli hazır SDK'lar
Bu ürünün OpenAPI'si (MaxCompute/2022-01-04), ROA imzalama yöntemini kullanır. Geliştiriciler için yaygın programlama dillerine yönelik SDK'ları kapsülledik. Geliştiriciler, bu ürünün OpenAPI'sini teknik ayrıntılarla uğraşmadan doğrudan çağırabilmek için SDK'yı indirebilir. Mevcut SDK ihtiyaçlarınızı karşılamıyorsa, kendi imzanızı oluşturmak üzere imzalama mekanizmasını kullanarak entegrasyon yapabilirsiniz. Kendi imzanızı oluşturma sürecinin ayrıntıları oldukça karmaşık olduğundan, bu işlem yaklaşık 5 iş günü sürebilir. Bu nedenle, DingTalk hizmet grubumuza (147535001692) katılmanızı ve uzman rehberliği altında imzalama entegrasyonu gerçekleştirmenizi öneririz.
API'yi kullanmadan önce, istemci araçları (SDK ve CLI gibi) aracılığıyla API'ye etkili bir şekilde erişebilmek için kimlik hesabınızı ve erişim anahtarınızı (AccessKey) hazırlamanız gerekir. Ayrıntılar için bkz. AccessKey Alma.
Özel imzalama senaryoları
İş senaryonuzun özel gereksinimleri varsa ve API'yi kendi imzanızı oluşturarak entegre etmeniz gerekiyorsa, profesyonel rehberlik almak ve verimli bir entegrasyon sağlamak için öncelikle teknik destek ekibimizle (DingTalk hizmet grubu: 147535001692) iletişime geçmenizi öneririz.
Hesap ve güvenlik hazırlığı
Alibaba Cloud hesapları, tüm kaynaklar üzerinde tam yönetici izinlerine sahiptir. Bir AccessKey ele geçirildiğinde, ilişkili tüm kaynaklar yetkisiz erişim riskiyle karşı karşıya kalır. Güvenliği sağlamak için, yalnızca API erişim izinlerine sahip bir RAM kullanıcısı oluşturmanız ve bunun AccessKey'ini yapılandırmanız; ayrıca en az ayrıcalık ilkesine (PoLP) dayalı olarak RAM ilkelerini yapılandırmanız önerilir. Alibaba Cloud hesabını yalnızca Alibaba Cloud hesabı izinlerinin açıkça gerekli olduğu belirli senaryolarda kullanın.
Kota yönetimi
|
API |
Başlık |
Açıklama |
| CreateQuota | Kota oluşturma. | Bir kota oluşturur. MaxCompute'u ilk kez etkinleştirirken bir kullandıkça öde kotası oluşturmanız gerekir. Abonelik kotası oluşturmanız durumunda, sistem ödemeyi otomatik olarak tahsil eder. |
| ListQuotas | Kota listesi | Kota listesini getirir. |
| QueryQuota | QueryQuota. | Belirtilen bir 1. seviye kota grubu hakkındaki bilgileri sorgular. |
| GetQuota | GetQuota. | Belirtilen 1. seviye kota grubunun bilgilerini getirir. Uyarı: Bu işlem 31 Temmuz 2024 tarihinde kullanımdan kaldırılacaktır. Yerini QueryQuota işlemi alacaktır. İki işlemin istek parametreleri, yanıt parametreleri ve özellikleri aynıdır. |
| İşlem kotası yapılandırması | İşlem kotası yapılandırması | |
| CreateComputeQuotaPlan | CreateComputeQuotaPlan. | Bir kota planı oluşturur. |
| UpdateComputeSubQuota | UpdateComputeSubQuota. | Bir MaxCompute kotasının temel yapılandırmasını günceller. Bu işlem, 2. seviye kotaların eklenmesini veya silinmesini, 2. seviye bir kotanın temel özniteliklerinin tanımlanmasını ve yürürlükteki bir kota planı için işlem birimlerinin (CU) yapılandırılmasını kapsar. |
| GetComputeQuotaPlan | GetComputeQuotaPlan. | Tek bir işlem kotası planının ayrıntılı bilgilerini getirir. |
| ListComputeQuotaPlan | ListComputeQuotaPlan. | Bilgi işlem kotası planlarını listeler. |
| UpdateComputeQuotaPlan | UpdateComputeQuotaPlan. | ComputeQuotaPlan'ı günceller. |
| DeleteComputeQuotaPlan | DeleteComputeQuotaPlan. | Bir MaxCompute kota planını siler. |
| ApplyComputeQuotaPlan | ApplyComputeQuotaPlan. | Bir kota planını anında etkinleştirir. |
| GetComputeQuotaSchedule | GetComputeQuotaSchedule. | İşlem kotasının zamana özel yapılandırmasını görüntüler. |
| UpdateComputeQuotaSchedule | UpdateComputeQuotaSchedule. | Bir bilgi işlem kotası için zamana dayalı zamanlamayı günceller. |
| GetComputeEffectivePlan | GetComputeEffectivePlan. | Etkin hesaplama planını getirir. |
| İşlem kotası yapılandırması (eski, önerilmez) | İşlem kotası yapılandırması (eski, önerilmez) | |
| CreateQuotaPlan | Kota planı oluşturma. | Bir kota planı oluşturur. |
| GetQuotaPlan | GetQuotaPlan. | Bir kota planının bilgilerini alır. |
| UpdateQuotaPlan | UpdateQuotaPlan. | Bir kota planını günceller. |
| ListQuotasPlans | ListQuotasPlans. | Kota planlarını alır. |
| DeleteQuotaPlan | DeleteQuotaPlan. | Bir kota planını siler. |
| UpdateQuotaSchedule | UpdateQuotaSchedule. | Bir kota planının zamanlama planını günceller. |
| GetQuotaSchedule | GetQuotaSchedule. | Bir kota planı için zamanlama planını getirir. |
Proje yönetimi
|
API |
Başlık |
Açıklama |
| Temel yönetim (Proje) | Temel yönetim (Proje) | |
| UpdateProjectBasicMeta | UpdateProjectBasicMeta. | Bir projenin temel bilgilerini değiştirir. |
| UpdateProjectDefaultQuota | UpdateProjectDefaultQuota. | Bir projenin varsayılan hesaplama kotasını günceller. |
| UpdateProjectIpWhiteList | UpdateProjectIpWhiteList. | Bir MaxCompute projesinin IP adresi beyaz listesini değiştirir. |
| UpdateProjectModelTier | UpdateProjectModelTier. | Bir projenin Katman 2 modelini Katman 3 modeline yükseltir. |
| GetTrustedProjects | GetTrustedProjects. | Mevcut projenin güvenilir projelerini alır. |
| Roller ve izinler (Rol, Kullanıcı) | Roller ve izinler (Rol, Kullanıcı) | |
| DeleteRole | DeleteRole. | MaxCompute'ta proje düzeyinde bir rolü siler. |
| ListProjectUsers | Proje kullanıcıları. | Bir projedeki kullanıcı listesini sorgular. |
| CreateRole | CreateRole. | MaxCompute proje düzeyinde bir rol oluşturur. |
| GetRoleAcl | GetRoleAcl. | Proje düzeyindeki bir role verilen ACL tabanlı izinleri alır. |
| GetRoleAclOnObject | GetRoleAclOnObject. | Proje düzeyindeki bir role bir nesne üzerinde verilen ACL tabanlı izinleri alır. |
| GetRolePolicy | GetRolePolicy. | Proje düzeyindeki bir role eklenen ilkeyi alır. |
| ListUsersByRole | ListUsersByRole. | Proje düzeyinde bir role atanan kullanıcılar hakkında bilgi alır. |
| UpdateUsersToRole | UpdateUsersToRole. | Bir proje rolüne kullanıcı ekler veya bir proje rolünden kullanıcı çıkarır. |
| Paket | Paket | |
| ListPackages | Paket listesi | Bir MaxCompute projesindeki paketlerin listesini getirir. |
| UpdatePackage | UpdatePackage. | Bir paketteki nesneleri ve paketin yüklenebileceği projeleri günceller. |
| CreatePackage | CreatePackage. | Bir paket oluşturur. |
| GetPackage | GetPackage. | Bir paketin bilgilerini alır. |
| Tablo | Tablo | |
| GetTableInfo | Tablo bilgilerini alma | MaxCompute dahili tabloları, görünümleri, harici tabloları, kümelenmiş tabloları veya işlemsel tabloları hakkındaki bilgileri sorgular. |
Kaynak gözlemlenebilirliği
|
API |
Başlık |
Açıklama |
| QueryQuotaMetric | İşlem kaynağı tüketim bilgilerini sorgulama | Kota kaynak tüketiminin zaman serisi bilgilerini sorgular. |
| QueryTunnelMetricDetail | QueryTunnelMetricDetail. | Belirtilen bir zaman aralığı için Tünel Veri İletim Hizmeti ile ilgili ayrıntıları sorgular. |
| QueryTunnelMetric | QueryTunnelMetric. | Belirtilen bir zaman aralığında Tunnel veri iletim hizmetine ait metrik verilerini sorgular. |
| GetQuotaUsage | GetQuotaUsage | Kota kaynak tüketimi bilgilerini sorgular. |
| ListJobMetric | İş performans metrikleri | Tamamlanan işlerin performans metriklerini getirir. |
| QueryStorageMetric | QueryStorageMetric. | Veri depolamanın zaman serisi metriklerini sorgular. |
| ListStorageTablesInfo | ListStorageTablesInfo. | Bir MaxCompute projesinin tablo depolama ayrıntılarını sorgular. |
| ListStoragePartitionsInfo | Bölüm depolama ayrıntıları | Belirtilen bir MaxCompute projesindeki bölümlenmiş bir tablonun her bir bölümünün depolama ayrıntılarını getirir. |
| GetStorageSizeSummary | GetStorageSizeSummary. | Depolama kullanımı özetini getirir. |
| GetStorageAmountSummary | Toplam depolama bilgilerini getirme. | Toplam depolama bilgilerini getirir. |
| GetStorageSummaryCompared | GetStorageSummaryCompared. | Depolama kullanımındaki yıldan yıla değişimi getirir. |
| ListStorageProjectsInfo | MaxCompute projelerinin depolama ayrıntılarını getirir | MaxCompute projelerinin depolama ayrıntılarını getirir. |
Görev işletme ve bakımı
|
API |
Başlık |
Açıklama |
| ListJobInfos | İşleri listeler | İşleri listeler. |
| ListJobSnapshotInfos | İş anlık görüntülerini listeleme | Belirli bir zaman noktasındaki iş anlık görüntü verilerini getirir. |
| GetJobInfo | GetJobInfo. | Bir işin temel bilgilerini sorgular. |
| GetRunningJobs | GetRunningJobs. | Belirtilen bir zaman aralığında çalışır durumdaki işlerin çalışma durumu verilerini alır. |
| KillJobs | Bir işi sonlandırma | Çalışan bir işi sonlandırır. |
| GetJobResourceUsage | GetJobResourceUsage. | Belirtilen bir günde tamamlanan tüm işlerin istatistiklerini çıkarır ve her iş yürütücüsünün günlük toplam kaynak kullanımını elde eder. |
Veri geçişi
|
API |
Başlık |
Açıklama |
| RetryMmsTask | RetryMmsTask. | Bir geçiş görevini yeniden dener. |
| CreateMmsDataSource | Veri kaynağı oluşturma. | Migration Service (MMA 4.0) aracılığıyla veri kaynağından MaxCompute'a veri geçişi gerçekleştirmek için bir veri kaynağı oluşturur. |
| GetMmsDataSource | GetMmsDataSource | Tek bir MaxCompute Migration Assist (MMA) veri kaynağının ayrıntılarını getirir. |
| ListMmsDataSources | Veri kaynaklarını listeleme | MMA veri kaynaklarını listeler. |
| UpdateMmsDataSource | UpdateMmsDataSource. | MaxCompute Migration Assist (MMA) veri kaynağının meta verilerini yeniler. |
| DeleteMmsDataSource | DeleteMmsDataSource. | Bir MaxCompute Migration Assist (MMA) veri kaynağını ve ilişkili geçiş planları ile meta verilerini siler. |
| CreateMmsFetchMetadataJob | Meta veri çekme işi. | Bir veri kaynağından meta veri çekmek için bir iş oluşturur. |
| GetMmsFetchMetadataJob | GetMmsFetchMetadataJob. | Meta verileri getiren bir MaxCompute Migration Assist (MMA) işinin ayrıntılarını sorgular. |
| ListMmsDbs | Bir veri kaynağındaki veritabanlarını listele | Bir MMA veri kaynağındaki veritabanlarını listeler. |
| GetMmsDb | GetMmsDb | MaxCompute Migration Assist (MMA) veri kaynağından bir veritabanı getirir. |
| ListMmsTables | ListMmsTables | MaxCompute Migration Assist (MMA) veri kaynağındaki tabloları listeler. |
| GetMmsTable | GetMmsTable | MaxCompute Migration Assist (MMA) veri kaynağından bir tablo getirir. |
| ListMmsPartitions | ListMmsPartitions | MaxCompute Migration Assist (MMA) veri kaynağındaki bölümleri listeler. |
| GetMmsPartition | GetMmsPartition | MaxCompute Migration Assist (MMA) veri kaynağından bir bölümü getirir. |
| CreateMmsJob | CreateMmsJob. | Bir veri geçişi görevi oluşturur. |
| ListMmsJobs | ListMmsJobs. | Geçiş işlerini listeler. |
| GetMmsJob | Tek bir geçiş işinin ayrıntılarını getirme. | Tek bir MMA geçiş planının ayrıntılarını getirir. |
| GetMmsAsyncTask | Veri geçişiyle ilgili tek bir zaman uyumsuz görevin ayrıntılarını getirme | MMA'da tek bir zaman uyumsuz görevi getirir. |
| DeleteMmsJob | DeleteMmsJob. | Bir MaxCompute Migration Assist (MMA) veri geçiş planını siler. |
| StartMmsJob | StartMmsJob. | Bir veri geçiş görevini başlatır. |
| StopMmsJob | StopMmsJob. | Bir veri geçişi işini durdurur. |
| RetryMmsJob | Veri geçişi görevini yeniden deneme. | Bir veri geçişi görevini yeniden dener. |
| ListMmsTasks | Veri geçişi görevleri listesi | Geçiş görevlerinin listesini sorgular. |
| GetMmsTask | GetMmsTask | Belirli bir geçiş görevinin ayrıntılarını getirir. |
| ListMmsTaskLogs | Tek bir geçiş görevinin çalıştırma günlükleri | Tek bir geçiş görevinin çalıştırma günlüklerini listeler. |
| CreateMmsTimer | Zamanlanmış veri geçişi görevi oluşturma | Zamanlanmış bir veri geçişi görevi oluşturur. |
| UpdateMmsTimer | Zamanlanmış bir görevi güncelleme. | Zamanlanmış bir görevi günceller. |
| UpdateMmsTables | UpdateMmsTables. | Tablo meta verilerini günceller. |
| UpdateMmsTable | UpdateMmsTable. | Tablo meta verilerini günceller. |
| UpdateMmsDb | UpdateMmsDb. | Belirtilen bir veritabanının meta verilerini günceller. |
| ListMmsTimers | Veri geçişi için zamanlanmış görevleri listeleme | Veri geçişi için zamanlanmış görevleri listeler. |
| ListMmsTimerLogs | Zamanlanmış görev günlüklerini listele | Zamanlanmış görevlerin günlüklerini listeler. |
| ListMmsDataSourceConfigItems | ListMmsDataSourceConfigItems. | Belirtilen bir veri kaynağı türü için yapılandırma öğelerini listeler. |
| GetMmsTimer | GetMmsTimer. | GetMmsTimer. |
| DeleteMmsTimer | DeleteMmsTimer. | Belirtilen bir veri kaynağından bir zamanlayıcıyı siler. |
Maliyet analizi
|
API |
Başlık |
Açıklama |
| ListInstances | ListInstances. | Belirtilen bir zaman aralığında maliyet analizi için proje listesini getirir. |
| SumStorageMetricsByType | Depolama türüne göre depolama kullanımını sorgulama. | Depolama türüne göre depolama kullanım istatistiklerini sorgular. |
| ListComputeMetricsBySignature | ListComputeMetricsBySignature. | İmzaya göre işlerin ayrıntılı hesaplama kullanımını görüntüler. |
| SumComputeMetricsByUsage | SumComputeMetricsByUsage. | Taranan veri hacmine veya CU kullanımına göre hesaplama kullanımını toplar. |
| SumComputeMetricsByRecord | SumComputeMetricsByRecord. | Kullanım kayıtlarının toplam sayısını hesaplar. |
| SumDailyBillsByItem | SumDailyBillsByItem. | Örnek veya faturalandırılabilir öğeye göre maliyetlerin günlük dökümünü görüntüler. |
| SumBills | SumBills. | Proje veya faturalandırılabilir öğeye göre maliyet bilgilerini özetler. |
| SumBillsByDate | SumBillsByDate. | Örnek veya faturalandırılabilir öğeye göre gruplandırılmış günlük maliyet özetini getirir. |
| SumStorageMetricsByDate | SumStorageMetricsByDate. | Belirtilen bir tarih aralığında, projeye veya depolama sınıfına göre gruplandırılmış toplu depolama metriklerini getirir. |
| ListComputeMetricsByInstance | Örnek düzeyinde iş hesaplama kullanımı. | Örnek düzeyinde iş hesaplama kullanımını listeler. |
Diğerleri
|
API |
Başlık |
Açıklama |
| TriggerMmsTimer | TriggerMmsTimer. | Belirli bir veri kaynağı için bir zamanlayıcı tetikler. |
| CreateProject | Proje oluşturma. | Bir MaxCompute projesi oluşturur. |
| DeleteProject | DeleteProject. | Bir MaxCompute projesini siler. Bu işlem geri alınamaz. Bu API'yi dikkatle kullanın. |
| GetLogviewDownloadUrl | Çevrimdışı Logview indirme bağlantısını alma | Belirtilen bir MaxCompute projesindeki bir örneğin çevrimdışı Logview dosyası için indirme bağlantısını alır. Bağlantı, oluşturulduğu andan itibaren 10 dakika boyunca geçerlidir. |
| GetProject | Proje bilgilerini alma. | Bir MaxCompute projesinin temel bilgilerini sorgular. |
| ListFunctions | ListFunctions. | Bir MaxCompute projesindeki işlevleri alır. |
| ListProjects | Projeleri listele | MaxCompute projelerini listeler. |
| ListResources | Kaynakları listele | Bir MaxCompute projesindeki kaynakların listesini getirir. |
| ListRoles | ListRoles. | MaxCompute proje düzeyindeki rolleri alır. |
| ListTables | ListTables. | Bir MaxCompute projesindeki tabloları getirir. |
| ListUsers | ListUsers. | Bir MaxCompute projesindeki kullanıcıları getirir. |
| ListTunnelQuotaTimer | ListTunnelQuotaTimer. | Tunnel için ayrılmış kaynak grubunun (Tunnel kotası olarak anılır) zamana özgü yapılandırmasını görüntüler. |