ListServices API によるサービスの一覧 - PAI - Alibaba Cloud - Platform For AI

サービスの一覧を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

eas:ListServices

get

*サービス。

acs:eas:{#regionId}:{#accountId}:service/*

なし

リクエスト構文

GET /api/v2/services HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Sort	string	任意	ソートフィールド。タイムスタンプフィールドはデフォルトで降順にソートされます。	CreateTime
Order	string	任意	ソート順序。有効な値: desc (デフォルト): 降順。 asc: 昇順。	asc
Filter	string	任意	あいまい一致フィールド。サービス名によるあいまい一致のみサポートされます。	foo
PageNumber	integer	任意	サービスリストのページ番号。デフォルト値: 1。	1
PageSize	integer	任意	ページング使用時に各ページに表示するサービス数。デフォルト値: 100。	100
GroupName	string	任意	サービスグループ名。サービスグループ名のフォーマットおよび取得方法については、「 ListServices 」を参照してください。	foo
ParentServiceUid	string	任意	Band メンバーサービスに対応するプライマリサービスの ID。	eas-m-ijafy3c8cxxxx
ServiceType	string	任意	サービスタイプ。有効な値: Async 標準 Queue LLM RAG Serverless LLMGatewayService Offline Task SDCluster ScalableJob ScalableJobService AssistantJob 列挙値: Async : 非同期サービス。 Standard : 標準デプロイ。 OfflineTask : オフラインタスク。 Proxima : Proxima	標準
Label	object	任意	ラベルでサービスをフィルターします。
	string	任意	ラベルを {"key":"value"} フォーマットで指定します。値は null または空の文字列にすることができ、その場合はキーのみがフィルターに使用されることを意味します。値は任意の値にできます。	{"キー1":"値1","キー2":null}
ServiceStatus	string	任意	サービスのステータス。列挙値: Creating : Creating。 Stopped : Stopped。 Failed : Failed。 Complete : Complete。 Cloning : Cloning。 Stopping : Stopping。 Updating : Updating。 Waiting : Waiting。 HotUpdate : HotUpdate。 Committing : Committing。 Starting : Starting。 DeleteFailed : DeleteFailed。 Running : Running。 Developing : Developing。 Scaling : Scaling。 Deleted : Deleted。 Pending : Pending。 Deleting : Deleting。	Running
ServiceName	string	任意	サービス名。	echo_test
ServiceUid	string	任意	サービスの UID。	eas-m-c9iw3yitxxxx
ResourceName `deprecated`	string	任意	サービスが属するリソースグループの名前または ID。	eas-r-hd0qwy8cxxxx
WorkspaceId	string	任意	ワークスペース ID。	1234**
QuotaId	string	任意	クォータ ID。	クォータ1****
Gateway	string	任意	専用ゲートウェイの ID。	gw-1uhcqmsc7x22******
Role	string	任意	サービスロール。列挙値: DataLoader : DataLoader。 FrontEnd : FrontEnd。 DataSet : DataSet。 SDProxy : SDProxy。 LLMScheduler : LLMScheduler。 ScalableJob : ScalableJob。 LLMGateway : LLMGateway。 Job : Job。 Queue : Queue。	LLMGateway
ResourceType	string	任意	サービスで使用されるリソースのタイプ。有効な値: PublicResource 専用 (DedicatedResource) Lingjun SelfManagedLingjun 列挙値: Lingjun : Lingjun リソースクォータ。 PublicResource : パブリックリソースグループ。 DedicatedResource : 専用リソースグループ。 SelfManagedLingjun : Lingjun 自己管理型リソースグループ。	PublicResource
IncludeNoWorkspace	boolean	任意	いずれのワークスペースにも属さないサービスを含めるかどうかを指定します。デフォルト値: true。	true
ResourceAliasName	string	任意	リソースグループのカスタム名。	example
ResourceId	string	任意	リソースグループの ID。リソースグループ ID のフォーマットおよびクエリ方法については、「 ListResources 」を参照してください。	eas-r-asdas****
ResourceBurstable	boolean	任意	サービスに対してバースト可能なリソースプールが有効になっているかどうかを指定します。列挙値: true : true。 false : false。	true
CronscalerEnabled	boolean	任意	サービスに対してスケジュールされた auto scaling が有効になっているかどうかを指定します。列挙値: true : true。 false : false。	true
AutoscalerEnabled	boolean	任意	サービスの弾力的スケーリングが有効かどうかを指定します。列挙値: true : true。 false : false。	true
TrafficState	string	任意	サービスがグループのトラフィックを処理するかどうかを指定します。このパラメーターはグループサービスに対してのみ有効です。列挙値: standalone : No. grouping : はい。	grouping
CallerUid	string	任意	サービスを作成したアカウントの UID。	19989224166xxxxxxx
Accessibility	string	任意	可視性でサービスをフィルタリングします。PUBLIC は公開サービスを示します。PRIVATE は非公開サービスを示します。列挙値: PUBLIC : 公開サービス。 PRIVATE : 非公開サービス。	PUBLIC

レスポンスフィールド

フィールド	型	説明	例
	object	応答。
RequestId	string	リクエスト ID。	40325405-579C-4D82****
Services	array	サービスのリスト。
	Service	サービスインスタンス。
PageNumber	integer	返されるサービスリストの現在のページ番号。	1
PageSize	integer	各ページに表示されるサービス数。	100
TotalCount	integer	サービスの総数。	2

例

成功レスポンス

JSONJSON

{
  "RequestId": "40325405-579C-4D82****",
  "Services": [
    {
      "RequestId": "40325405-579C-4D82********",
      "Region": "cn-shanghai",
      "CallerUid": "20123*******",
      "ParentUid": "11234*******",
      "CurrentVersion": 1,
      "Cpu": 1,
      "Gpu": 0,
      "Image": "registry.cn-shanghai.aliyuncs.com/eas/echo_cn-shanghai:v0.0.1-20210129111320",
      "PendingInstance": 0,
      "RunningInstance": 1,
      "TotalInstance": 1,
      "InternetEndpoint": "http://10123*****.cn-shanghai.aliyuncs.com/api/predict/echo",
      "IntranetEndpoint": "http://10123*****.vpc.cn-shanghai.aliyuncs.com/api/predict/echo",
      "LatestVersion": 1,
      "Memory": 1024,
      "Message": "Service start successfully",
      "Namespace": "echo",
      "Reason": "RUNNING",
      "Resource": "eas-r-xxxxxxx",
      "ResourceAlias": "my_resource",
      "ServiceConfig": "{\"metadata\":{\"cpu\":1,\"instance\":1,\"memory\":1024},\"name\":\"echo\",\"processor_entry\":\"libecho.so\",\"processor_path\":\"http://oss-cn-hangzhou-zmf.aliyuncs.com/059247/echo_processor_release.tar.gz\",\"processor_type\":\"cpp\"}",
      "ServiceName": "echo",
      "ServiceGroup": "my_group",
      "Status": "Running",
      "CreateTime": "2021-01-29T11:13:20Z",
      "UpdateTime": "2021-01-29T11:13:20Z",
      "Weight": 100,
      "ServiceId": "eas-m-xxasdat",
      "ServiceUid": "eas-m-xxasdat\n",
      "AccessToken": "MzJiMDI5MDliODc0MTlkYmI0ZDhlYmExYjczYTIyZTE3Zm********",
      "Source": "dsw",
      "ExtraData": "{\"blue_green_services\":[\"test\",\"testxxxx\"]}",
      "Role": "Queue",
      "RoleAttrs": "{\"ApproxMaxLength\":null,\"Length\":null,\"MaxPayloadBytes\":null}",
      "SafetyLock": "dangerous",
      "SecondaryInternetEndpoint": "http://10123*****.cn-shanghai.aliyuncs.com/api/predict/async_path.echo\n",
      "SecondaryIntranetEndpoint": "http://10123*****.vpc.cn-shanghai.aliyuncs.com/api/predict/async_path.echo\n",
      "Labels": [
        {
          "LabelKey": "key1",
          "LabelValue": "value1"
        }
      ],
      "WorkspaceId": "123445",
      "AppType": "LLM",
      "AppConfig": "{\"ModelStorage\":\"oss\"}",
      "AppSpecName": "llama_7b_fp16",
      "AppVersion": "v1",
      "TrafficState": "standalone",
      "QuotaId": "quotaxxxxx",
      "Gateway": "gw-xxxxxx",
      "GPUMemory": 20,
      "GPUCorePercentage": 50,
      "ResourceBurstable": true,
      "CronscalerEnabled": true,
      "AutoscalerEnabled": true,
      "InstanceCountInResource": {
        "Public": 10,
        "Dedicated": 10,
        "Quota": 10
      },
      "WorkloadType": ""
    }
  ],
  "PageNumber": 1,
  "PageSize": 100,
  "TotalCount": 2
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。