diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/dbfs/2020-04-18/api-docs.php | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/zh_cn/dbfs/2020-04-18/api-docs.php')
| -rw-r--r-- | data/zh_cn/dbfs/2020-04-18/api-docs.php | 8890 |
1 files changed, 3434 insertions, 5456 deletions
diff --git a/data/zh_cn/dbfs/2020-04-18/api-docs.php b/data/zh_cn/dbfs/2020-04-18/api-docs.php index 76dc46b..46bc415 100644 --- a/data/zh_cn/dbfs/2020-04-18/api-docs.php +++ b/data/zh_cn/dbfs/2020-04-18/api-docs.php @@ -1,102 +1,55 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'RPC', - 'product' => 'DBFS', - 'version' => '2020-04-18', - ], + 'info' => ['style' => 'RPC', 'product' => 'DBFS', 'version' => '2020-04-18'], 'directories' => [ [ - 'id' => 134159, - 'title' => '实例基本操作', + 'children' => ['CreateDbfs', 'UpdateDbfs', 'DeleteDbfs', 'AttachDbfs', 'DetachDbfs', 'RenameDbfs', 'ResizeDbfs', 'ListDbfs', 'GetDbfs', 'ListDbfsAttachableEcsInstances', 'ListDbfsAttachedEcsInstances'], 'type' => 'directory', - 'children' => [ - 'CreateDbfs', - 'UpdateDbfs', - 'DeleteDbfs', - 'AttachDbfs', - 'DetachDbfs', - 'RenameDbfs', - 'ResizeDbfs', - 'ListDbfs', - 'GetDbfs', - 'ListDbfsAttachableEcsInstances', - 'ListDbfsAttachedEcsInstances', - ], + 'title' => '实例基本操作', + 'id' => 320494, ], [ - 'id' => 134170, - 'title' => '快照', - 'type' => 'directory', 'children' => [ - 'CreateSnapshot', - 'DeleteSnapshot', - 'ModifySnapshotAttribute', 'ListSnapshot', 'GetSnapshotLink', 'ListSnapshotLinks', [ - 'id' => 177098, - 'title' => '自动快照策略', + 'children' => ['GetAutoSnapshotPolicy', 'ListAutoSnapshotPolicies', 'ListAutoSnapshotPolicyUnappliedDbfs', 'ListAutoSnapshotPolicyAppliedDbfs'], 'type' => 'directory', - 'children' => [ - 'CreateAutoSnapshotPolicy', - 'CancelAutoSnapshotPolicy', - 'ApplyAutoSnapshotPolicy', - 'DeleteAutoSnapshotPolicy', - 'ModifyAutoSnapshotPolicy', - 'GetAutoSnapshotPolicy', - 'ListAutoSnapshotPolicies', - 'ListAutoSnapshotPolicyUnappliedDbfs', - 'ListAutoSnapshotPolicyAppliedDbfs', - ], + 'title' => '自动快照策略', + 'id' => 320510, ], ], + 'type' => 'directory', + 'title' => '快照', + 'id' => 320506, ], [ - 'id' => 134174, - 'title' => '标签', + 'children' => ['DeleteTagsBatch', 'TagDbfs', 'AddTagsBatch'], 'type' => 'directory', - 'children' => [ - 'DeleteTagsBatch', - 'TagDbfs', - 'AddTagsBatch', - 'ListTagKeys', - 'ListTagValues', - ], + 'title' => '标签', + 'id' => 320523, ], [ - 'id' => 134180, - 'title' => '服务关联角色', + 'children' => ['GetServiceLinkedRole'], 'type' => 'directory', - 'children' => [ - 'CreateServiceLinkedRole', - 'GetServiceLinkedRole', - ], + 'title' => '服务关联角色', + 'id' => 320529, ], [ - 'id' => 169510, - 'title' => '其他', + 'children' => ['DescribeDbfsSpecifications', 'ApplyAutoSnapshotPolicy', 'CancelAutoSnapshotPolicy', 'CreateAutoSnapshotPolicy', 'CreateServiceLinkedRole', 'CreateSnapshot', 'DeleteAutoSnapshotPolicy', 'DeleteSnapshot', 'DescribeInstanceTypes', 'ListTagKeys', 'ListTagValues', 'ModifyAutoSnapshotPolicy', 'ModifySnapshotAttribute'], 'type' => 'directory', - 'children' => [ - 'DescribeDbfsSpecifications', - 'DescribeInstanceTypes', - ], + 'title' => '其他', + 'id' => 320532, ], ], 'components' => [ 'schemas' => [], ], 'apis' => [ - 'CreateDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'AddTagsBatch' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -105,480 +58,148 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '15800', - 'abilityTreeNodes' => [ - 'FEATUREdbfsUCP4CQ', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '15798', + 'abilityTreeNodes' => ['FEATUREdbfsQMJ6C8'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'FsName', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统名称。'."\n" - ."\n" - .'取值范围：2~128个字符，以英文大小写字母或中文开头，可包含数字、下划线和连字符（-）。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'testdbfs-001', - ], - ], - [ - 'name' => 'Category', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统类型。取值范围：'."\n" - .'- standard：标准版'."\n" - .'- enterprise：企业版', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'standard', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'SizeG', + 'name' => 'DbfsList', 'in' => 'query', - 'schema' => [ - 'description' => '容量大小，以GiB为单位。指定该参数后，其取值必须≥指定快照ID的容量大小。'."\n" - ."\n" - .'取值范围：不使能RAID0条带化时为20-32768之间的整数；使能RAID0条带化时为160-262144之间的整数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'minimum' => '20', - 'example' => '200', - ], + 'schema' => ['description' => '待添加标签的数据库文件系统实例列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '["dbfs-nUy1tb********BQ4X8Gpw","dbfs-v0WvA********tVEVcgJLg"]'], ], [ - 'name' => 'ZoneId', + 'name' => 'Tags', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的可用区ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou-i', - ], + 'schema' => ['description' => '待添加的标签列表。'."\n" + ."\n" + .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" + ."\n" + .' TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n", 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]'], ], [ 'name' => 'ClientToken', 'in' => 'query', - 'schema' => [ - 'description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', - 'type' => 'string', - 'required' => false, - 'example' => '123e4567-e89b-12d3-a456-426655440000', - ], - ], - [ - 'name' => 'SnapshotId', - 'in' => 'query', - 'schema' => [ - 'description' => '创建DBFS实例使用的快照ID。', - 'type' => 'string', - 'required' => false, - 'example' => 's-y2vZ3********vvMilZ2hQ', - ], - ], - [ - 'name' => 'DeleteSnapshot', - 'in' => 'query', - 'schema' => [ - 'description' => '使用快照创建DBFS后是否删除原始快照。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - 'default' => 'false', - ], - ], - [ - 'name' => 'PerformanceLevel', - 'in' => 'query', - 'schema' => [ - 'description' => '创建DBFS实例时，设置DBFS的性能等级。取值范围：'."\n" - ."\n" - .'- PL0：单盘最高随机读写IOPS 1万'."\n" - ."\n" - .'- PL1：单盘最高随机读写IOPS 5万（默认值）'."\n" - ."\n" - .'- PL2：单盘最高随机读写IOPS 10万'."\n" - ."\n" - .'- PL3：单盘最高随机读写IOPS 100万', - 'type' => 'string', - 'required' => false, - 'example' => 'PL1', - 'default' => 'PL1', - ], - ], - [ - 'name' => 'EnableRaid', - 'in' => 'query', - 'schema' => [ - 'description' => '是否以RAID方式来创建DBFS。'."\n" - ."\n" - .'取值范围：true或false，默认值为false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - 'default' => 'false', - ], - ], - [ - 'name' => 'RaidStripeUnitNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '条带数量。当EnableRaid参数为true时必传。'."\n" - ."\n" - .'取值范围：2-8之间的整数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '0', - 'example' => '8', - 'default' => '0', - ], - ], - [ - 'name' => 'KMSKeyId', - 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS使用的KMS密钥ID。', - 'type' => 'string', - 'required' => false, - 'example' => '0e478b7a-4262-4802-b8cb-00d3fb40826X', - ], - ], - [ - 'name' => 'Encryption', - 'in' => 'query', - 'schema' => [ - 'description' => '是否加密DBFS。'."\n" - ."\n" - .'取值范围：true或false，默认值为false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - 'default' => 'false', - ], - ], - [ - 'name' => 'UsedScene', - 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS的使用场景。取值范围：'."\n" - ."\n" - .'- MySQL 5.7'."\n" - ."\n" - .'- PostgreSQL'."\n" - ."\n" - .'- MongoDB'."\n" - ."\n" - .'- Oracle RAC', - 'type' => 'string', - 'required' => false, - 'example' => 'PostgreSQL', - ], - ], - [ - 'name' => 'InstanceType', - 'in' => 'query', - 'schema' => [ - 'description' => '实例规格。取值范围：'."\n" - ."\n" - .'- dbfs.small'."\n" - ."\n" - .'- dbfs.medium'."\n" - ."\n" - .'- dbfs.large（默认值）'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs.small', - ], - ], - [ - 'name' => 'AdvancedFeatures', - 'in' => 'query', - 'schema' => [ - 'description' => '可定制数据库文件存储实例使用的CPU核数、内存上限值等。'."\n" - ."\n" - .'- cpuCoreCount：CPU核数。'."\n" - .'- memorySize：内存大小，单位MB。'."\n" - .'- pageCacheSize：PageCache缓存大小，单位MB。', - 'type' => 'string', - 'required' => false, - 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}', - ], + 'schema' => ['description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。'."\n", 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => '123e4567-e89b-12d3-a456-426655440000'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'FsId' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidCategory.DBFS', - 'errorMessage' => 'The category is not supported.', - ], - [ - 'errorCode' => 'InvalidName.DBFS', - 'errorMessage' => 'Invalid DBFS instance name.', - ], - [ - 'errorCode' => 'InvalidPerformanceLevel.DBFS', - 'errorMessage' => 'The performance level is not supported.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'InvalidSize.DBFS', - 'errorMessage' => 'The size of DBFS is invalid.', - ], - [ - 'errorCode' => 'InvalidZone.DBFS', - 'errorMessage' => 'The zone is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.Snapshot', - 'errorMessage' => 'The snapshot does not exist.', - ], + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n</CreateDbfsResponse>","errorExample":""}]', - 'title' => '创建数据库文件系统', - 'summary' => '调用CreateDbfs创建一个按量付费的数据库文件系统。', - 'description' => '创建数据库文件系统需要通过实名认证。请前往会员信息中进行[实名认证](https://account.console.aliyun.com/)。'."\n" - ."\n" - .'创建数据库文件系统会涉及到资源计费，建议您提前了解数据库文件系统的计费方式。更多详情请参见[按量付费](https://help.aliyun.com/document_detail/149734.html)。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<AddTagsBatchResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</AddTagsBatchResponse>","errorExample":""}]', + 'title' => '批量设置标签', + 'summary' => '调用AddTagsBatch为多个数据库文件系统实例批量添加标签，可能存在新增标签与替换标签。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'UpdateDbfs' => [ - 'summary' => '修改一个数据库文件系统的实例规格和使用场景。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:AddTagsBatch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ApplyAutoSnapshotPolicy' => [ + 'summary' => '为一个或多个数据库文件系统设置自动快照策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'write', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '150809', - 'abilityTreeNodes' => [ - 'FEATUREdbfsS28E99', - 'FEATUREdbfsQMJ6C8', - ], - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PolicyId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ - 'name' => 'FsId', + 'name' => 'DbfsIds', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', + 'description' => '传入的需要设置该自动快照策略的数据库文件系统ID列表，传入的参数需要保持JSON数组格式，ID之间用半角逗号（,）隔开。例如：["dbfs-1luaxt4vs1iusrd`*******`", "dbfs-cxbyu98fspcbvm`******`“]。', + 'type' => 'array', + 'items' => ['description' => '需要设置该自动快照策略的数据库文件系统。', 'type' => 'string', 'required' => true, 'example' => '"dbfs-1luaxt4vs1iusrd*******"'], 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], - ], - [ - 'name' => 'UsedScene', - 'in' => 'query', - 'schema' => [ - 'description' => '修改后的使用场景。取值范围：'."\n" - ."\n" - .'- MySQL 5.7'."\n" - ."\n" - .'- PostgreSQL'."\n" - ."\n" - .'- MongoDB'."\n" - ."\n" - .'- Oracle RAC', - 'type' => 'string', - 'required' => false, - 'example' => 'MySQL 5.7', + 'minItems' => 1, ], ], [ - 'name' => 'InstanceType', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '修改后的实例规格。取值范围：'."\n" - ."\n" - .'- dbfs.small'."\n" - ."\n" - .'- dbfs.medium'."\n" - ."\n" - .'- dbfs.large（默认值）'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs.medium', - 'enum' => [ - 'dbfs.small', - 'dbfs.medium', - 'dbfs.large', - ], - ], - ], - [ - 'name' => 'AdvancedFeatures', - 'in' => 'query', - 'schema' => [ - 'description' => '可定制数据库文件存储实例使用的CPU核数、内存上限值等。', - 'type' => 'string', - 'required' => false, - 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结果', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ - 'title' => 'AccessDeniedDetail', - 'description' => 'AccessDeniedDetail', 'type' => 'object', 'properties' => [ - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -586,180 +207,51 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'InvalidStatus.DBFS', - 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', - ], - ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], + ['errorCode' => 'ParameterInvalid.DbfsIds', 'errorMessage' => 'The DbfsIds parameter is invalid.', 'description' => '文件系统列表格式不规范。'], + ['errorCode' => 'ParameterEmpty.PolicyId', 'errorMessage' => 'The value of policyId is empty.', 'description' => '策略ID值未填写。'], + ['errorCode' => 'DbfsAlreadyAppliedAutoSnapshotPolicy', 'errorMessage' => 'An automatic snapshot policy has been applied on the specified dbfs.', 'description' => '单个文件系统只支持设置一个自动快照策略。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"PolicyType\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '修改数据库文件系统', - ], - 'DeleteDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + ['errorCode' => 'PermissionDeny.Policy', 'errorMessage' => 'The account has no permission on this policy.', 'description' => ''], + ['errorCode' => 'PermissionDeny.DBFS', 'errorMessage' => 'The account has no permission on this DBFS.', 'description' => ''], ], - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '15803', - 'abilityTreeNodes' => [ - 'FEATUREdbfs3MBLW2', - ], - ], - 'parameters' => [ - [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 404 => [ + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], ], - [ - 'name' => 'FsId', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-9aqh1sqfqhc0w5********', - ], + 409 => [ + ['errorCode' => 'OperationConflict', 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', 'description' => '自动快照策略操作冲突，请稍后再试。'], ], - [ - 'name' => 'Force', - 'in' => 'query', - 'schema' => [ - 'title' => '是否强制删除。', - 'description' => '是否强制删除数据库文件系统。'."\n" - .'默认值：false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 503 => [ + ['errorCode' => 'AutoShapshotBusy', 'errorMessage' => 'The server is busy now, please try again later.', 'description' => '服务器繁忙，请稍后再试。'], ], ], - 'responses' => [ - 200 => [ - 'headers' => [], - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'AccessDeniedDetail' => [ - 'type' => 'object', - 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], - ], - ], + 'staticInfo' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '设置自动快照策略', + 'description' => '- 一个文件系统只能设置一条自动快照策略。若需要更换策略，请先取消原自动快照策略。'."\n" + .'- 一条自动快照策略支持应用到多个文件系统。'."\n" + ."\n" + .'数据库文件系统快照基于云盘快照，由云盘进行快照扣费。请确保在使用该接口前，已充分了解云盘快照的收费方式和[价格](https://help.aliyun.com/document_detail/56159.htm?spm=openapi-amp.newDocPublishment.0.0.4ada281fa5jFc7#concept-rq2-pcx-ydb)。', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:ApplyAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], ], ], ], ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'InvalidStatus.DBFS', - 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', - ], - ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], - ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DeleteDbfsResponse>","errorExample":""}]', - 'title' => '删除数据库文件系统', - 'summary' => '调用DeleteDbfs释放一个按量付费的数据库文件系统。', - 'description' => '调用该接口时，您需要注意：'."\n" - ."\n" - .'释放数据库文件系统时，数据库文件系统的状态必须为：待挂载（Unattached）。'."\n" - .'如果指定ID的数据库文件系统不存在，请求将被忽略。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], 'AttachDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -767,77 +259,42 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'ECSInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '目标ECS实例的ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'i-bp1ecr********5go2go', - ], + 'schema' => ['description' => '目标ECS实例的ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'i-bp1ecr********5go2go'], ], [ 'name' => 'ServerUrl', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS软件包地址，已废弃不再使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs-pkg-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com', - ], + 'schema' => ['description' => 'DBFS软件包地址，已废弃不再使用。', 'type' => 'string', 'required' => false, 'example' => 'dbfs-pkg-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com'], ], [ 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '待挂载的数据库文件系统ID。'."\n" - .'数据库文件系统（FsId）和ECS实例（ECSInstanceId）必须在同一个可用区内。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-v0WvA********tVEVcgJLg', - ], + 'schema' => ['description' => '待挂载的数据库文件系统ID。'."\n" + .'数据库文件系统（FsId）和ECS实例（ECSInstanceId）必须在同一个可用区内。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-v0WvA********tVEVcgJLg'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'AttachMode', 'in' => 'query', - 'schema' => [ - 'description' => '挂载模式。取值范围：'."\n" - .'```'."\n" - .'create_new_mount_point - 创建新挂载点（默认值）'."\n" - .'use_exist_mount_point - 使用已有挂载点'."\n" - .'```'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'create_new_mount_point', - ], + 'schema' => ['description' => '挂载模式。取值范围：'."\n" + .'```'."\n" + .'create_new_mount_point - 创建新挂载点（默认值）'."\n" + .'use_exist_mount_point - 使用已有挂载点'."\n" + .'```'."\n", 'type' => 'string', 'required' => false, 'example' => 'create_new_mount_point'], ], [ 'name' => 'AttachPoint', 'in' => 'query', - 'schema' => [ - 'description' => '挂载点路径，不填写则随机生成。', - 'type' => 'string', - 'required' => false, - 'example' => '/mnt/dbfs/dbfs-001', - ], + 'schema' => ['description' => '挂载点路径，不填写则随机生成。', 'type' => 'string', 'required' => false, 'example' => '/mnt/dbfs/dbfs-001'], ], ], 'responses' => [ @@ -846,67 +303,31 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.ECS', - 'errorMessage' => 'The ECS instance does not exist.', - ], + ['errorCode' => 'EntityNotExist.ECS', 'errorMessage' => 'The ECS instance does not exist.', 'description' => 'ECS实例不存在。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<AttachDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</AttachDbfsResponse>","errorExample":""}]', @@ -919,111 +340,78 @@ 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'DetachDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:AttachDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'CancelAutoSnapshotPolicy' => [ + 'summary' => '取消一个或多个数据库文件系统的自动快照策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'FsId', + 'name' => 'PolicyId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'd-bp131n0q38u3a4zi*****', - ], + 'schema' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ - 'name' => 'ECSInstanceId', + 'name' => 'DbfsIds', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '待卸载的ECS实例ID。', - 'type' => 'string', + 'description' => '传入的需要取消该自动快照策略的数据库文件系统列表，传入的参数需要保持JSON数组格式，ID之间用半角逗号（,）隔开。例如：["dbfs-1luaxt4vs1iusrd`*******`","dbfs-cxbyu98fspcbvm`******`"]。', + 'type' => 'array', + 'items' => ['description' => '传入的需要取消该自动快照策略的数据库文件系统。', 'type' => 'string', 'required' => true, 'example' => '"dbfs-1luaxt4vs1iusrd*******"'], 'required' => true, - 'docRequired' => true, - 'example' => 'i-bp67acfmxazb4ph***', + 'minItems' => 1, ], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -1031,127 +419,128 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'DbfsWithAutoSnapshotPolicy.NotFound', 'errorMessage' => 'Dbfs cancel failed.The specified dbfs does not apply this auto snapshot policy or does not exist.', 'description' => '取消自动快照策略失败，策略不存在或文件系统未绑定该策略。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'ParameterEmpty.PolicyId', 'errorMessage' => 'The value of policyId is empty.', 'description' => '策略ID值未填写。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.ECS', - 'errorMessage' => 'The ECS instance does not exist.', + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], + ], + 409 => [ + ['errorCode' => 'OperationConflict', 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', 'description' => '自动快照策略操作冲突，请稍后再试。'], + ], + 503 => [ + ['errorCode' => 'AutoShapshotBusy', 'errorMessage' => 'The server is busy now, please try again later.', 'description' => '服务器繁忙，请稍后再试。'], + ], + ], + 'staticInfo' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '取消自动快照策略', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:CancelAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DetachDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DetachDbfsResponse>","errorExample":""}]', - 'title' => '卸载数据库文件系统', - 'summary' => '调用DetachDbfs从一台ECS实例上卸载一个按量付费的数据库文件系统。', - 'description' => '调用该接口时，请注意：'."\n" - ."\n" - .'- 数据库文件系统必须已经挂载到实例上，状态为已挂载（Attached)。'."\n" - ."\n" - .'- 卸载数据库文件系统时，所挂载的ECS实例必须处于运行中（Running）或者已停止（Stopped）状态。'."\n" - ."\n" - .'- DetachDbfs是异步操作，调用接口成功后等待一分钟左右才能完成卸载。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], - 'RenameDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateAutoSnapshotPolicy' => [ + 'summary' => '在指定地域下创建一条自动快照策略。自动快照策略可以周期性地为数据库文件系统创建快照备份数据。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '15818', - 'abilityTreeNodes' => [ - 'FEATUREdbfs3HYCOJ', - ], + 'operationType' => 'create', + 'abilityTreeCode' => '150683', + 'abilityTreeNodes' => ['FEATUREdbfsOC34E7'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ - 'name' => 'FsName', + 'name' => 'PolicyName', 'in' => 'query', + 'schema' => ['title' => '自动快照策略名称', 'description' => '策略名称。', 'type' => 'string', 'required' => true, 'example' => 'policyTest'], + ], + [ + 'name' => 'RetentionDays', + 'in' => 'query', + 'schema' => ['title' => '保留天数', 'description' => '保留天数。', 'type' => 'integer', 'format' => 'int32', 'deprecated' => false, 'required' => true, 'maximum' => '65536', 'minimum' => '-1', 'example' => '30'], + ], + [ + 'name' => 'RepeatWeekdays', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '重命名后的数据库文件系统名称。'."\n" + 'title' => '重复星期', + 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" ."\n" - .'取值范围：长度为2~128个字符，以英文大小写字母或中文开头，可包含数字、下划线和连字符（-）。', - 'type' => 'string', + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + ."\n" + .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的重复日期，周期为星期。', 'type' => 'string', 'required' => true, 'example' => '"1"'], 'required' => true, - 'docRequired' => true, - 'example' => 'NewDbfsName', + 'maxItems' => 7, + 'minItems' => 1, ], ], [ - 'name' => 'FsId', + 'name' => 'TimePoints', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', + 'title' => '重复时间', + 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" + ."\n" + .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的创建时间点。', 'type' => 'string', 'required' => true, 'example' => '"01"'], 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', + 'maxItems' => 24, + 'minItems' => 1, ], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-zhangjiakou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '6AE8A242-E12D-55AC-A75D-F707020AD0D6', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'PolicyId' => ['description' => '自动快照策略ID', 'type' => 'string', 'example' => 'sp-z5siir3iq3m**********'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'AuthAction' => [ - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'type' => 'string', - ], - 'PolicyType' => [ - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -1159,35 +548,36 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidName.DBFS', - 'errorMessage' => 'Invalid DBFS instance name.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'ParameterInvalid.RetentionDays', 'errorMessage' => 'The RetentionDays parameter is invalid.', 'description' => '保留时间参数无效。'], + ['errorCode' => 'ParameterInvalid.RepeatWeekDays', 'errorMessage' => 'The RepeatWeekdays parameter is invalid.', 'description' => '重复日期无效。'], + ['errorCode' => 'ParameterInvalid.TimePoints', 'errorMessage' => 'The TimePoints parameter is invalid.', 'description' => '重复时间无效。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'ParameterInvalid.PolicyName', 'errorMessage' => 'The PolicyName parameter is invalid.', 'description' => '自动快照策略名称无效。'], ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '创建自动快照策略', + 'description' => '数据库文件系统快照基于云盘快照，由云盘进行快照扣费。请确保在使用该接口前，已充分了解云盘快照的收费方式和[价格](https://help.aliyun.com/document_detail/56159.htm?spm=a2c4g.11186623.0.0.19dd5496Onr9aK#concept-rq2-pcx-ydb)。', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"6AE8A242-E12D-55AC-A75D-F707020AD0D6\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"PolicyType\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '重命名数据库文件系统', - 'summary' => '调用RenameDbfs重命名一个数据库文件系统。', ], - 'ResizeDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -1196,649 +586,229 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'create', + 'abilityTreeCode' => '15800', + 'abilityTreeNodes' => ['FEATUREdbfsUCP4CQ'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'FsId', + 'name' => 'FsName', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], + 'schema' => ['description' => '数据库文件系统名称。'."\n" + ."\n" + .'取值范围：2~128个字符，以英文大小写字母或中文开头，可包含数字、下划线和连字符（-）。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'testdbfs-001'], ], [ - 'name' => 'NewSizeG', + 'name' => 'Category', 'in' => 'query', - 'schema' => [ - 'description' => '扩容后的数据库文件系统容量，必须大于扩容前的数据库文件系统容量。单位GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'docRequired' => true, - 'minimum' => '20', - 'example' => '40', - ], + 'schema' => ['description' => '数据库文件系统类型。取值范围：'."\n" + .'- standard：标准版'."\n" + .'- enterprise：企业版', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'standard'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'AccessDeniedDetail' => [ - 'type' => 'object', - 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], - ], - ], - ], - ], + [ + 'name' => 'SizeG', + 'in' => 'query', + 'schema' => ['description' => '容量大小，以GiB为单位。指定该参数后，其取值必须≥指定快照ID的容量大小。'."\n" + ."\n" + .'取值范围：不使能RAID0条带化时为20-32768之间的整数；使能RAID0条带化时为160-262144之间的整数。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'minimum' => '20', 'example' => '200'], ], - ], - 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'InvalidSize.DBFS', - 'errorMessage' => 'The size of DBFS is invalid.', - ], - [ - 'errorCode' => 'InvalidStatus.DBFS', - 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', - ], + [ + 'name' => 'ZoneId', + 'in' => 'query', + 'schema' => ['description' => 'DBFS实例所属的可用区ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou-i'], ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => ['description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', 'type' => 'string', 'required' => false, 'example' => '123e4567-e89b-12d3-a456-426655440000'], ], - ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ResizeDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</ResizeDbfsResponse>","errorExample":""}]', - 'title' => '扩容数据库文件系统', - 'summary' => '调用ResizeDbfs扩容一个数据库文件系统。', - 'description' => '- 扩容后的数据库文件系统容量必须大于扩容前的容量。'."\n" - ."\n" - .'- 数据库文件系统的状态必须为已挂载（attached）。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', - ], - 'ListDbfs' => [ - 'summary' => '调用ListDbfs查询您已经创建的数据库文件系统列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'SnapshotId', + 'in' => 'query', + 'schema' => ['description' => '创建DBFS实例使用的快照ID。', 'type' => 'string', 'required' => false, 'example' => 's-y2vZ3********vvMilZ2hQ'], ], - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREdbfsUCP4CQ', + [ + 'name' => 'DeleteSnapshot', + 'in' => 'query', + 'schema' => ['description' => '使用快照创建DBFS后是否删除原始快照。', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'], ], - 'tenantRelevance' => 'publicInformation', - ], - 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PerformanceLevel', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '创建DBFS实例时，设置DBFS的性能等级。取值范围：'."\n" + ."\n" + .'- PL0：单盘最高随机读写IOPS 1万'."\n" + ."\n" + .'- PL1：单盘最高随机读写IOPS 5万（默认值）'."\n" + ."\n" + .'- PL2：单盘最高随机读写IOPS 10万'."\n" + ."\n" + .'- PL3：单盘最高随机读写IOPS 100万', 'type' => 'string', 'required' => false, 'example' => 'PL1', 'default' => 'PL1'], ], [ - 'name' => 'PageNumber', + 'name' => 'EnableRaid', 'in' => 'query', - 'schema' => [ - 'description' => '当前页码。'."\n" - ."\n" - .'默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => true, - 'maximum' => '999999', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '是否以RAID方式来创建DBFS。'."\n" + ."\n" + .'取值范围：true或false，默认值为false。', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'], ], [ - 'name' => 'PageSize', + 'name' => 'RaidStripeUnitNumber', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。'."\n" - ."\n" - .'最大值：100。'."\n" - ."\n" - .'默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], + 'schema' => ['description' => '条带数量。当EnableRaid参数为true时必传。'."\n" + ."\n" + .'取值范围：2-8之间的整数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'example' => '8', 'default' => '0'], ], [ - 'name' => 'SortKey', + 'name' => 'KMSKeyId', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时设置排序方式。'."\n" - ."\n" - .'与SortType配合使用，取值必须为SizeG或CreatedTime。'."\n" - ."\n" - .'取值为SizeG则根据容量排序，取值为CreatedTime则根据创建时间排序。'."\n" - ."\n" - .'默认根据创建时间倒序排列。', - 'type' => 'string', - 'required' => false, - 'example' => 'SizeG', - ], + 'schema' => ['description' => 'DBFS使用的KMS密钥ID。', 'type' => 'string', 'required' => false, 'example' => '0e478b7a-4262-4802-b8cb-00d3fb40826X'], ], [ - 'name' => 'SortType', + 'name' => 'Encryption', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时设置排序方式。'."\n" - ."\n" - .'与SortKey配合使用，取值必须为asc或desc。'."\n" - ."\n" - .'取值为asc则正序排列，取值为desc则正序排列。'."\n" - ."\n" - .'默认根据创建时间倒序排列。', - 'type' => 'string', - 'required' => false, - 'example' => 'desc', - ], + 'schema' => ['description' => '是否加密DBFS。'."\n" + ."\n" + .'取值范围：true或false，默认值为false。', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'], ], [ - 'name' => 'FilterKey', + 'name' => 'UsedScene', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" - ."\n" - .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'FsName', - ], + 'schema' => ['description' => 'DBFS的使用场景。取值范围：'."\n" + ."\n" + .'- MySQL 5.7'."\n" + ."\n" + .'- PostgreSQL'."\n" + ."\n" + .'- MongoDB'."\n" + ."\n" + .'- Oracle RAC', 'type' => 'string', 'required' => false, 'example' => 'PostgreSQL'], ], [ - 'name' => 'FilterValue', + 'name' => 'InstanceType', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs-test-01', - ], + 'schema' => ['description' => '实例规格。取值范围：'."\n" + ."\n" + .'- dbfs.small'."\n" + ."\n" + .'- dbfs.medium'."\n" + ."\n" + .'- dbfs.large（默认值）'."\n", 'type' => 'string', 'required' => false, 'example' => 'dbfs.small'], ], [ - 'name' => 'Tags', + 'name' => 'AdvancedFeatures', 'in' => 'query', - 'schema' => [ - 'description' => '根据标签筛选数据库文件系统列表。'."\n" - ."\n" - .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" - ."\n" - .' TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', - 'type' => 'string', - 'required' => false, - 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]', - ], + 'schema' => ['description' => '可定制数据库文件存储实例使用的CPU核数、内存上限值等。'."\n" + ."\n" + .'- cpuCoreCount：CPU核数。'."\n" + .'- memorySize：内存大小，单位MB。'."\n" + .'- pageCacheSize：PageCache缓存大小，单位MB。', 'type' => 'string', 'required' => false, 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '32', - ], - 'PageSize' => [ - 'description' => '输入时设置的每页条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'PageNumber' => [ - 'description' => '当前页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'DBFSInfo' => [ - 'description' => '数据库文件系统集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'- unattached 待挂载'."\n" - ."\n" - .'- attached 已挂载'."\n" - ."\n" - .'- creating 创建中'."\n" - ."\n" - .'- attaching 挂载中'."\n" - ."\n" - .'- detaching 卸载中'."\n" - ."\n" - .'- deleting 删除中'."\n" - ."\n" - .'- deleted 已删除'."\n" - ."\n" - .'- resizing 扩容中'."\n" - ."\n" - .'- snapshotting 快照中'."\n" - ."\n" - .'- upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'Encryption' => [ - 'description' => '是否为加密的数据库文件系统。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'PayType' => [ - 'description' => '数据库文件系统的付费类型，目前仅支持按量付费（postpaid）。', - 'type' => 'string', - 'example' => 'postpaid', - ], - 'FsId' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], - 'Tags' => [ - 'description' => '标签集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TagValue' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => 'TestTagValue1', - ], - 'Id' => [ - 'description' => '标签ID。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'TagKey' => [ - 'description' => '标签键。', - 'type' => 'string', - 'example' => 'TestTagKey1', - ], - ], - ], - ], - 'SizeG' => [ - 'description' => '数据库文件系统大小，单位GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'EcsList' => [ - 'description' => '挂载到的ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'EcsId' => [ - 'description' => '已挂载的ECS实例ID。', - 'type' => 'string', - 'example' => 'i-y2vZ3********vvMilZ2hQ', - ], - ], - ], - ], - 'EbsList' => [ - 'description' => '云盘列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'EbsId' => [ - 'description' => 'DBFS使用的云盘ID。', - 'type' => 'string', - 'example' => 'd-bp1383******3uir001r', - ], - 'SizeG' => [ - 'description' => '云盘容量。单位GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - ], - ], - ], - 'RegionId' => [ - 'description' => '数据库文件系统所属的地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'DBFSClusterId' => [ - 'description' => '数据库文件系统集群ID。', - 'type' => 'string', - 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD', - ], - 'ZoneId' => [ - 'description' => '数据库文件系统所属的可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-i', - ], - 'FsName' => [ - 'description' => '数据库文件系统名称。', - 'type' => 'string', - 'example' => 'dbfs-test-01', - ], - 'Category' => [ - 'description' => '数据库文件系统类型。取值范围：'."\n" - ."\n" - .'- standard：标准版'."\n" - ."\n" - .'- enterprise：企业版（公测中）', - 'type' => 'string', - 'example' => 'standard', - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '1609330367000', - ], - 'AttachNodeNumber' => [ - 'description' => '数据库文件系统挂载的节点数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'KMSKeyId' => [ - 'description' => '数据库文件系统使用的KMS密钥ID。', - 'type' => 'string', - 'example' => '0e478b7a-4262-4802-b8cb-00d3fb408***', - ], - 'PerformanceLevel' => [ - 'description' => '云盘性能等级。取值范围：'."\n" - ."\n" - .'- PL0'."\n" - ."\n" - .'- PL1'."\n" - ."\n" - .'- PL2'."\n" - ."\n" - .'- PL3', - 'type' => 'string', - 'example' => 'PL1', - ], - 'UsedScene' => [ - 'description' => '使用场景。', - 'type' => 'string', - 'example' => 'MySQL 5.7', - ], - 'LastMountTime' => [ - 'description' => '最后挂载时间。', - 'type' => 'string', - 'example' => '1644915400000', - ], - 'LastUmountTime' => [ - 'description' => '最后卸载时间。', - 'type' => 'string', - 'example' => '1644915319000', - ], - 'EnableRaid' => [ - 'description' => '是否使能RAID。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'RaidStrip' => [ - 'description' => '条带数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'InstanceType' => [ - 'description' => 'DBFS实例规格。取值范围：'."\n" - ."\n" - .'- dbfs.small'."\n" - ."\n" - .'- dbfs.medium'."\n" - ."\n" - .'- dbfs.large', - 'type' => 'string', - 'example' => 'dbfs.small', - ], - 'LastFailed' => [ - 'description' => '最近一次操作失败的原因。', - 'type' => 'string', - 'example' => 'TargetIsBusy.DBFS', - ], - 'SnapshotInfo' => [ - 'description' => '相关快照信息。', - 'type' => 'object', - 'properties' => [ - 'SnapshotCount' => [ - 'description' => '快照总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'TotalSize' => [ - 'description' => '快照链中所有快照的大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50331648', - ], - 'LinkId' => [ - 'description' => '快照链id，若没有快照链则为“-”。', - 'type' => 'string', - 'example' => 'sl-b3zlgraysgcs9jy*******', - ], - 'PolicyId' => [ - 'description' => '自动快照策略id，若没有设置自动快照策略则为“-”。', - 'type' => 'string', - 'example' => 'sp-ehuhzlfetb2jiwz*******', - ], - ], - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'FsId' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidCategory.DBFS', 'errorMessage' => 'The category is not supported.', 'description' => '非法的版本类型。'], + ['errorCode' => 'InvalidName.DBFS', 'errorMessage' => 'Invalid DBFS instance name.', 'description' => '非法的DBFS实例名称。'], + ['errorCode' => 'InvalidPerformanceLevel.DBFS', 'errorMessage' => 'The performance level is not supported.', 'description' => '非法的性能等级。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'InvalidSize.DBFS', 'errorMessage' => 'The size of DBFS is invalid.', 'description' => '非法的容量大小。'], + ['errorCode' => 'InvalidZone.DBFS', 'errorMessage' => 'The zone is not supported.', 'description' => '不支持的可用区。'], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.Snapshot', 'errorMessage' => 'The snapshot does not exist.', 'description' => '快照不存在。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 32,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"DBFSInfo\\": [\\n {\\n \\"Status\\": \\"attached\\",\\n \\"Encryption\\": false,\\n \\"PayType\\": \\"postpaid\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"Tags\\": [\\n {\\n \\"TagValue\\": \\"TestTagValue1\\",\\n \\"Id\\": 1,\\n \\"TagKey\\": \\"TestTagKey1\\"\\n }\\n ],\\n \\"SizeG\\": 20,\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-y2vZ3********vvMilZ2hQ\\"\\n }\\n ],\\n \\"EbsList\\": [\\n {\\n \\"EbsId\\": \\"d-bp1383******3uir001r\\",\\n \\"SizeG\\": 20\\n }\\n ],\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBFSClusterId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"FsName\\": \\"dbfs-test-01\\",\\n \\"Category\\": \\"standard\\",\\n \\"CreatedTime\\": \\"1609330367000\\",\\n \\"AttachNodeNumber\\": 1,\\n \\"KMSKeyId\\": \\"0e478b7a-4262-4802-b8cb-00d3fb408***\\",\\n \\"PerformanceLevel\\": \\"PL1\\",\\n \\"UsedScene\\": \\"MySQL 5.7\\",\\n \\"LastMountTime\\": \\"1644915400000\\",\\n \\"LastUmountTime\\": \\"1644915319000\\",\\n \\"EnableRaid\\": false,\\n \\"RaidStrip\\": 2,\\n \\"InstanceType\\": \\"dbfs.small\\",\\n \\"LastFailed\\": \\"TargetIsBusy.DBFS\\",\\n \\"SnapshotInfo\\": {\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648,\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\",\\n \\"PolicyId\\": \\"sp-ehuhzlfetb2jiwz*******\\"\\n }\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TotalCount>32</TotalCount>\\n<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<PageSize>10</PageSize>\\n<PageNumber>1</PageNumber>\\n<DBFSInfo>\\n <Status>attached</Status>\\n <LastFailed>TargetIsBusy.DBFS</LastFailed>\\n <KMSKeyId>0e478b7a-4262-4802-b8cb-00d3fb408***</KMSKeyId>\\n <CreatedTime>1609330367000</CreatedTime>\\n <Category>standard</Category>\\n <EnableRaid>false</EnableRaid>\\n <ZoneId>cn-hangzhou-i</ZoneId>\\n <SizeG>20</SizeG>\\n <PerformanceLevel>PL1</PerformanceLevel>\\n <DBFSClusterId>c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD</DBFSClusterId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n <LastUmountTime>1644915319000</LastUmountTime>\\n <PayType>postpaid</PayType>\\n <Encryption>false</Encryption>\\n <FsName>dbfs-test-01</FsName>\\n <UsedScene>MySQL 5.7</UsedScene>\\n <RaidStrip>2</RaidStrip>\\n <LastMountTime>1644915400000</LastMountTime>\\n <AttachNodeNumber>1</AttachNodeNumber>\\n <RegionId>cn-hangzhou</RegionId>\\n <InstanceType>dbfs.small</InstanceType>\\n <EcsList>\\n <EcsId>i-y2vZ3********vvMilZ2hQ</EcsId>\\n </EcsList>\\n <EbsList>\\n <SizeG>20</SizeG>\\n <EbsId>d-bp1383******3uir001r</EbsId>\\n </EbsList>\\n <Tags>\\n <TagKey>TestTagKey1</TagKey>\\n <Id>1</Id>\\n <TagValue>TestTagValue1</TagValue>\\n </Tags>\\n</DBFSInfo>","errorExample":""}]', - 'title' => '查询数据库文件系统列表', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n</CreateDbfsResponse>","errorExample":""}]', + 'title' => '创建数据库文件系统', + 'summary' => '调用CreateDbfs创建一个按量付费的数据库文件系统。', + 'description' => '创建数据库文件系统需要通过实名认证。请前往会员信息中进行[实名认证](https://account.console.aliyun.com/)。'."\n" + ."\n" + .'创建数据库文件系统会涉及到资源计费，建议您提前了解数据库文件系统的计费方式。更多详情请参见[按量付费](https://help.aliyun.com/document_detail/149734.html)。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'GetDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/*'], + ], + ], + 'additionalActions' => [ + ['action' => 'dbfs:CreateServiceLinkedRole'], + ], + ], ], + ], + 'CreateServiceLinkedRole' => [ + 'summary' => '调用CreateServiceLinkedRole创建服务关联角色，用于DBFS操作其它依赖的云资源。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeCode' => '15801', + 'abilityTreeNodes' => ['FEATUREdbfsUCP4CQ'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'FsId', + 'name' => 'ClientToken', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], + 'schema' => ['description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', 'type' => 'string', 'required' => false, 'example' => '123e4567-e89b-12d3-a456-426655440000'], + ], + [ + 'name' => 'AutoCreateServiceLinkedRole', + 'in' => 'query', + 'schema' => ['type' => 'string', 'required' => false, 'description' => ''], ], ], 'responses' => [ @@ -1846,416 +816,97 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'DBFSInfo' => [ - 'description' => '数据库文件系统实例。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'- unattached 待挂载'."\n" - ."\n" - .'- attached 已挂载'."\n" - ."\n" - .'- creating 创建中'."\n" - ."\n" - .'- attaching 挂载中'."\n" - ."\n" - .'- detaching 卸载中'."\n" - ."\n" - .'- deleting 删除中'."\n" - ."\n" - .'- deleted 已删除'."\n" - ."\n" - .'- resizing 扩容中'."\n" - ."\n" - .'- snapshotting 快照中'."\n" - ."\n" - .'- upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'PayType' => [ - 'description' => '数据库文件系统的付费类型，目前仅支持按量付费（postpaid）。', - 'type' => 'string', - 'example' => 'postpaid', - ], - 'FsId' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], - 'Tags' => [ - 'description' => '标签集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'TagValue' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => 'TestTagValue1', - ], - 'Id' => [ - 'description' => '标签ID。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'TagKey' => [ - 'description' => '标签键。', - 'type' => 'string', - 'example' => 'TestTagKey1', - ], - ], - ], - ], - 'SizeG' => [ - 'description' => '数据库文件系统大小，单位GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'EcsList' => [ - 'description' => '挂载到的ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'EcsId' => [ - 'description' => '已挂载的ECS实例ID。', - 'type' => 'string', - 'example' => 'i-y2vZ3********vvMilZ2hQ', - ], - ], - ], - ], - 'RegionId' => [ - 'description' => '数据库文件系统所属的地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'DBFSClusterId' => [ - 'description' => '数据库文件系统集群ID。', - 'type' => 'string', - 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD', - ], - 'Description' => [ - 'description' => '数据库文件系统描述信息。', - 'type' => 'string', - 'example' => 'desc', - ], - 'ZoneId' => [ - 'description' => '数据库文件系统所属的可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-i', - ], - 'FsName' => [ - 'description' => '数据库文件系统名称。', - 'type' => 'string', - 'example' => 'dbfs-test-01', - ], - 'Category' => [ - 'description' => '数据库文件系统类型。取值范围：'."\n" - ."\n" - .'- standard：标准版'."\n" - ."\n" - .'- enterprise：企业版（公测中）', - 'type' => 'string', - 'example' => 'standard', - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '1609330367000', - ], - 'AttachNodeNumber' => [ - 'description' => '数据库文件系统挂载的节点数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'KMSKeyId' => [ - 'description' => 'KMS密钥ID。', - 'type' => 'string', - 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4D******', - ], - 'Encryption' => [ - 'description' => '是否已加密。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'PerformanceLevel' => [ - 'description' => '云盘性能等级。取值范围：'."\n" - ."\n" - .'- PL0'."\n" - ."\n" - .'- PL1'."\n" - ."\n" - .'- PL2'."\n" - ."\n" - .'- PL3', - 'type' => 'string', - 'example' => 'PL1', - ], - 'UsedScene' => [ - 'description' => '使用场景。', - 'type' => 'string', - 'example' => 'MySQL 5.7', - ], - 'LastMountTime' => [ - 'description' => '最后挂载时间。', - 'type' => 'string', - 'example' => '1644915400000', - ], - 'LastUmountTime' => [ - 'description' => '最后卸载时间。', - 'type' => 'string', - 'example' => '1644915319000', - ], - 'EnableRaid' => [ - 'description' => '是否使能RAID。', - 'type' => 'boolean', - 'example' => 'false', - ], - 'InstanceType' => [ - 'description' => 'DBFS实例规格。取值范围：'."\n" - ."\n" - .'- dbfs.small'."\n" - ."\n" - .'- dbfs.medium'."\n" - ."\n" - .'- dbfs.large', - 'type' => 'string', - 'example' => 'dbfs.small', - ], - 'RaidStrip' => [ - 'description' => '条数个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '2', - ], - 'EbsList' => [ - 'description' => 'DBFS使用的云盘列表。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'EbsId' => [ - 'description' => '云盘ID。', - 'type' => 'string', - 'example' => 'd-bp1hq4******qi7gy1th', - ], - 'SizeG' => [ - 'description' => '云盘容量。单位GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - ], - ], - ], - 'LastFailed' => [ - 'description' => '最近一次操作失败原因。', - 'type' => 'string', - 'example' => 'TargetIsBusy.DBFS', - ], - 'SnapshotInfo' => [ - 'description' => '快照相关信息。', - 'type' => 'object', - 'properties' => [ - 'SnapshotCount' => [ - 'description' => '快照数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'LinkId' => [ - 'description' => '快照链id，若没有快照链则为“-”。', - 'type' => 'string', - 'example' => 'sl-9zskwvgoqqqvzxa*******', - ], - 'TotalSize' => [ - 'description' => '快照容量。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50331648', - ], - 'PolicyId' => [ - 'description' => '自动快照策略id，若没有设置自动快照策略则为“-”。', - 'type' => 'string', - 'example' => 'sp-ehuhzlfetb2jiwz*******', - ], - ], - ], - 'AdvancedFeatures' => [ - 'description' => '数据库文件存储实例使用的CPU核数、内存上限值等。'."\n" - ."\n" - .'- cpuCoreCount：CPU核数。'."\n" - .'- memorySize：内存大小，单位MB。'."\n" - .'- pageCacheSize：PageCache缓存大小，单位MB。', - 'type' => 'string', - 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}', - ], - 'SnapshotId' => [ - 'description' => '创建DBFS实例使用的快照ID。', - 'type' => 'string', - 'example' => 's-uvwtoxcjj6xtlua*******', - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.(EntityNotExist.DBFS)', + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateServiceLinkedRoleResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</CreateServiceLinkedRoleResponse>","errorExample":""}]', + 'title' => '创建服务关联角色', + 'description' => '权限说明：允许数据库文件存储访问您ECS和私网连接的权限，使用该权限查询、创建、扩容、挂载、卸载、删除ECS云盘，查询、创建、删除云盘快照以及创建私网连接服务。', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateServiceLinkedRole', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DBFSInfo\\": {\\n \\"Status\\": \\"attached\\",\\n \\"PayType\\": \\"postpaid\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"Tags\\": [\\n {\\n \\"TagValue\\": \\"TestTagValue1\\",\\n \\"Id\\": 1,\\n \\"TagKey\\": \\"TestTagKey1\\"\\n }\\n ],\\n \\"SizeG\\": 20,\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-y2vZ3********vvMilZ2hQ\\"\\n }\\n ],\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBFSClusterId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD\\",\\n \\"Description\\": \\"desc\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"FsName\\": \\"dbfs-test-01\\",\\n \\"Category\\": \\"standard\\",\\n \\"CreatedTime\\": \\"1609330367000\\",\\n \\"AttachNodeNumber\\": 1,\\n \\"KMSKeyId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4D******\\",\\n \\"Encryption\\": false,\\n \\"PerformanceLevel\\": \\"PL1\\",\\n \\"UsedScene\\": \\"MySQL 5.7\\",\\n \\"LastMountTime\\": \\"1644915400000\\",\\n \\"LastUmountTime\\": \\"1644915319000\\",\\n \\"EnableRaid\\": false,\\n \\"InstanceType\\": \\"dbfs.small\\",\\n \\"RaidStrip\\": 2,\\n \\"EbsList\\": [\\n {\\n \\"EbsId\\": \\"d-bp1hq4******qi7gy1th\\",\\n \\"SizeG\\": 20\\n }\\n ],\\n \\"LastFailed\\": \\"TargetIsBusy.DBFS\\",\\n \\"SnapshotInfo\\": {\\n \\"SnapshotCount\\": 1,\\n \\"LinkId\\": \\"sl-9zskwvgoqqqvzxa*******\\",\\n \\"TotalSize\\": 50331648,\\n \\"PolicyId\\": \\"sp-ehuhzlfetb2jiwz*******\\"\\n },\\n \\"AdvancedFeatures\\": \\"{\\\\\\"cpuCoreCount\\\\\\":0.5,\\\\\\"memorySize\\\\\\":512,\\\\\\"pageCacheSize\\\\\\":128}\\",\\n \\"SnapshotId\\": \\"s-uvwtoxcjj6xtlua*******\\"\\n },\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<DBFSInfo>\\n <Status>attached</Status>\\n <LastFailed>TargetIsBusy.DBFS</LastFailed>\\n <KMSKeyId>c39EcDBf-2Ecb-C3C6-6526-018d4D******</KMSKeyId>\\n <CreatedTime>1609330367000</CreatedTime>\\n <Category>standard</Category>\\n <Description>desc</Description>\\n <EnableRaid>false</EnableRaid>\\n <ZoneId>cn-hangzhou-i</ZoneId>\\n <SizeG>20</SizeG>\\n <PerformanceLevel>PL1</PerformanceLevel>\\n <DBFSClusterId>c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD</DBFSClusterId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n <LastUmountTime>1644915319000</LastUmountTime>\\n <Encryption>false</Encryption>\\n <PayType>postpaid</PayType>\\n <FsName>dbfs-test-01</FsName>\\n <UsedScene>MySQL 5.7</UsedScene>\\n <RaidStrip>2</RaidStrip>\\n <LastMountTime>1644915400000</LastMountTime>\\n <AttachNodeNumber>1</AttachNodeNumber>\\n <RegionId>cn-hangzhou</RegionId>\\n <InstanceType>dbfs.small</InstanceType>\\n <EcsList>\\n <EcsId>i-y2vZ3********vvMilZ2hQ</EcsId>\\n </EcsList>\\n <EbsList>\\n <SizeG>20</SizeG>\\n <EbsId>d-bp1hq4******qi7gy1th</EbsId>\\n </EbsList>\\n <Tags>\\n <TagKey>TestTagKey1</TagKey>\\n <Id>1</Id>\\n <TagValue>TestTagValue1</TagValue>\\n </Tags>\\n</DBFSInfo>","errorExample":""}]', - 'title' => '查询单个数据库文件系统', - 'summary' => '调用GetDbfs查询数据库文件系统详细信息。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], - 'ListDbfsAttachableEcsInstances' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'CreateSnapshot' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PageNumber', + 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '当前页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'd-bp131n0q38u3a4zi*****'], ], [ - 'name' => 'PageSize', + 'name' => 'SnapshotName', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页行数。默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '10', - 'default' => '100', - ], + 'schema' => ['description' => '快照的显示名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以`http://`和`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。'."\n" + ."\n" + .'为防止和自动快照的名称冲突，不能以auto开头和dbfs-auto开头。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'testSnapshotName'], ], [ - 'name' => 'FilterKey', + 'name' => 'Description', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为InstanceId或InstanceName。'."\n" - ."\n" - .'传入InstanceId则根据ECS实例ID进行筛选，传入InstanceName则根据ECS实例名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'InstanceName', - ], + 'schema' => ['description' => '快照的描述。长度为2~256个英文或中文字符，不能以`http://`和`https://`开头。'."\n" + ."\n" + .'默认值：空。', 'type' => 'string', 'required' => false, 'docRequired' => true, 'example' => 'testDescription'], ], [ - 'name' => 'FilterValue', + 'name' => 'RetentionDays', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'autotest1', - ], + 'schema' => ['description' => '设置快照的保留时间，单位为天。保留时间到期后快照会被自动释放，取值范围：1~65536'."\n" + ."\n" + .'默认值：空，表示快照不会被自动释放。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => true, 'maximum' => '36500', 'minimum' => '-1', 'example' => '30'], + ], + [ + 'name' => 'ClientToken', + 'in' => 'query', + 'schema' => ['description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', 'type' => 'string', 'required' => false, 'example' => '123e4567-e89b-12d3-a456-426655440000'], ], ], 'responses' => [ @@ -2263,133 +914,67 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '3724CFEF-02DA-578B-AED6-67EE80671B4A', - ], - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '32', - ], - 'EcsLabelInfo' => [ - 'description' => 'ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'description' => 'ECS实例信息。', - 'type' => 'object', - 'properties' => [ - 'value' => [ - 'description' => 'ECS实例ID。', - 'type' => 'string', - 'example' => 'i-bp10jb8mqajkmrejgo00', - ], - 'label' => [ - 'description' => 'ECS实例名称。', - 'type' => 'string', - 'example' => 'dbfs-test-01', - ], - 'InstanceTypeFamily' => [ - 'description' => 'ECS实例规格族。', - 'type' => 'string', - 'example' => 'ecs.g7se', - ], - 'OSName' => [ - 'description' => 'ECS实例的操作系统名称。', - 'type' => 'string', - 'example' => 'Alibaba Cloud Linux 2.1903 LTS 64 bit', - ], - 'Status' => [ - 'description' => 'ECS实例状态：'."\n" - .'- Pending：创建中。'."\n" - .'- Running：运行中。'."\n" - .'- Starting：启动中。'."\n" - .'- Stopping：停止中。'."\n" - .'- Stopped：已停止。', - 'type' => 'string', - 'example' => 'Running', - ], - 'ZoneId' => [ - 'description' => '可用区ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou-i', - ], - 'ImageId' => [ - 'description' => '镜像ID。', - 'type' => 'string', - 'example' => 'm-bp67acfmxazb4p****', - ], - ], - ], - ], + 'SnapshotId' => ['description' => '快照ID。', 'type' => 'string', 'example' => 's-Q2greuDZTvWeS8bfKZ****'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'InvalidStatus.DBFS', 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', 'description' => ''], + ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"SnapshotId\\": \\"s-Q2greuDZTvWeS8bfKZ****\\",\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateSnapshotResponse>\\n <SnapshotId>s-Q2greuDZTvWeS8bfKZ****</SnapshotId>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</CreateSnapshotResponse>","errorExample":""}]', + 'title' => '创建快照', + 'summary' => '调用CreateSnapshot给一个数据库文件系统创建快照。', + 'description' => '以下场景中，您无法为指定的数据库文件系统创建快照：'."\n" + ."\n" + .'- 上一份快照还未完成创建。'."\n" + ."\n" + .'- 数据库文件系统实例未处于已挂载（Attached）或者待挂载（Unattached）状态。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3724CFEF-02DA-578B-AED6-67EE80671B4A\\",\\n \\"TotalCount\\": 32,\\n \\"EcsLabelInfo\\": [\\n {\\n \\"value\\": \\"i-bp10jb8mqajkmrejgo00\\",\\n \\"label\\": \\"dbfs-test-01\\",\\n \\"InstanceTypeFamily\\": \\"ecs.g7se\\",\\n \\"OSName\\": \\"Alibaba Cloud Linux 2.1903 LTS 64 bit\\",\\n \\"Status\\": \\"Running\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"ImageId\\": \\"m-bp67acfmxazb4p****\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '查询可挂载的ECS实例', - 'summary' => '调用ListDbfsAttachableEcsInstances查询数据库文件系统可挂载的ECS实例列表。', ], - 'ListDbfsAttachedEcsInstances' => [ - 'summary' => '调用ListDbfsAttachedEcsInstances查询数据库文件系统已挂载的ECS实例列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeleteAutoSnapshotPolicy' => [ + 'summary' => '删除一条自动快照策略。删除后，已经设置了该自动快照策略的文件系统将自动取消策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['https', 'http'], 'security' => [ [ 'AK' => [], @@ -2397,121 +982,39 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PolicyId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ - 'name' => 'FsId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-nUy1tb********BQ4X8Gpw', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'BaseResponse', + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'EcsLabelInfo' => [ - 'description' => 'ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'MountPoint' => [ - 'description' => '数据库文件系统挂载点。', - 'type' => 'string', - 'example' => '/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw', - ], - 'value' => [ - 'description' => 'ECS实例ID。', - 'type' => 'string', - 'example' => 'i-bp10jb8mqajkmrejgo00', - ], - 'label' => [ - 'description' => 'ECS实例名称。', - 'type' => 'string', - 'example' => 'dbfs-test-01', - ], - 'MountedTime' => [ - 'description' => '数据库文件系统挂载时间。用时间戳表示，单位毫秒。', - 'type' => 'string', - 'example' => '1606290930000', - ], - 'InstanceTypeFamily' => [ - 'description' => 'ECS实例规格族。', - 'type' => 'string', - 'example' => 'ecs.g7se', - ], - 'OSName' => [ - 'description' => 'ECS实例的操作系统名称。', - 'type' => 'string', - 'example' => 'Alibaba Cloud Linux 2.1903 LTS 64 bit', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC********'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -2519,33 +1022,44 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'ParameterEmpty.PolicyId', 'errorMessage' => 'The value of policyId is empty.', 'description' => '策略ID值未填写。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + [ + ['errorCode' => 'PermissionDeny.Policy', 'errorMessage' => 'The account has no permission on this policy.', 'description' => ''], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], + ], + 409 => [ + ['errorCode' => 'OperationConflict', 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', 'description' => '自动快照策略操作冲突，请稍后再试。'], + ], + 503 => [ + ['errorCode' => 'AutoShapshotBusy', 'errorMessage' => 'The server is busy now, please try again later.', 'description' => '服务器繁忙，请稍后再试。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC********\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '删除自动快照策略', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:DeleteAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"EcsLabelInfo\\": [\\n {\\n \\"MountPoint\\": \\"/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw\\",\\n \\"value\\": \\"i-bp10jb8mqajkmrejgo00\\",\\n \\"label\\": \\"dbfs-test-01\\",\\n \\"MountedTime\\": \\"1606290930000\\",\\n \\"InstanceTypeFamily\\": \\"ecs.g7se\\",\\n \\"OSName\\": \\"Alibaba Cloud Linux 2.1903 LTS 64 bit\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<EcsLabelInfo>\\n <MountPoint>/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw</MountPoint>\\n <InstanceTypeFamily>ecs.g7se</InstanceTypeFamily>\\n <OSName>Alibaba Cloud Linux 2.1903 LTS 64 bit</OSName>\\n <MountedTime>1606290930000</MountedTime>\\n <label>dbfs-test-01</label>\\n <value>i-bp10jb8mqajkmrejgo00</value>\\n</EcsLabelInfo>","errorExample":""}]', - 'title' => '查询已挂载的ECS实例', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], - 'CreateSnapshot' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DeleteDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2554,182 +1068,93 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'create', + 'operationType' => 'delete', + 'abilityTreeCode' => '15803', + 'abilityTreeNodes' => ['FEATUREdbfs3MBLW2'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'd-bp131n0q38u3a4zi*****', - ], - ], - [ - 'name' => 'SnapshotName', - 'in' => 'query', - 'schema' => [ - 'description' => '快照的显示名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以`http://`和`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。'."\n" - ."\n" - .'为防止和自动快照的名称冲突，不能以auto开头和dbfs-auto开头。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'testSnapshotName', - ], - ], - [ - 'name' => 'Description', - 'in' => 'query', - 'schema' => [ - 'description' => '快照的描述。长度为2~256个英文或中文字符，不能以`http://`和`https://`开头。'."\n" - ."\n" - .'默认值：空。', - 'type' => 'string', - 'required' => false, - 'docRequired' => true, - 'example' => 'testDescription', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-9aqh1sqfqhc0w5********'], ], [ - 'name' => 'RetentionDays', - 'in' => 'query', - 'schema' => [ - 'description' => '设置快照的保留时间，单位为天。保留时间到期后快照会被自动释放，取值范围：1~65536'."\n" - ."\n" - .'默认值：空，表示快照不会被自动释放。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => true, - 'maximum' => '36500', - 'minimum' => '-1', - 'example' => '30', - ], - ], - [ - 'name' => 'ClientToken', + 'name' => 'Force', 'in' => 'query', - 'schema' => [ - 'description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', - 'type' => 'string', - 'required' => false, - 'example' => '123e4567-e89b-12d3-a456-426655440000', - ], + 'schema' => ['title' => '是否强制删除。', 'description' => '是否强制删除数据库文件系统。'."\n" + .'默认值：false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'SnapshotId' => [ - 'description' => '快照ID。', - 'type' => 'string', - 'example' => 's-Q2greuDZTvWeS8bfKZ****', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'InvalidStatus.DBFS', - 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'InvalidStatus.DBFS', 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', 'description' => ''], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"SnapshotId\\": \\"s-Q2greuDZTvWeS8bfKZ****\\",\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateSnapshotResponse>\\n <SnapshotId>s-Q2greuDZTvWeS8bfKZ****</SnapshotId>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</CreateSnapshotResponse>","errorExample":""}]', - 'title' => '创建快照', - 'summary' => '调用CreateSnapshot给一个数据库文件系统创建快照。', - 'description' => '以下场景中，您无法为指定的数据库文件系统创建快照：'."\n" - ."\n" - .'- 上一份快照还未完成创建。'."\n" + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DeleteDbfsResponse>","errorExample":""}]', + 'title' => '删除数据库文件系统', + 'summary' => '调用DeleteDbfs释放一个按量付费的数据库文件系统。', + 'description' => '调用该接口时，您需要注意：'."\n" ."\n" - .'- 数据库文件系统实例未处于已挂载（Attached）或者待挂载（Unattached）状态。', + .'释放数据库文件系统时，数据库文件系统的状态必须为：待挂载（Unattached）。'."\n" + .'如果指定ID的数据库文件系统不存在，请求将被忽略。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-01-05T01:43:51.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'DeleteSnapshot' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2737,46 +1162,27 @@ ], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'SnapshotId', 'in' => 'query', - 'schema' => [ - 'description' => '快照ID或者快照ID列表。'."\n" - .'- 删除单个快照时输入快照ID'."\n" - .'- 批量删除时以JSON数组形式输入快照ID，ID之间用半角逗号（,）隔开，一次最多指定100个快照ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 's-Q2greuDZTvWeS8bfKZ**** '."\n" - .'或者["s-Q2greuDZTvWeS8bfKZ****","s-r4qlmevirw2vwmwv7*****"]', - ], + 'schema' => ['description' => '快照ID或者快照ID列表。'."\n" + .'- 删除单个快照时输入快照ID'."\n" + .'- 批量删除时以JSON数组形式输入快照ID，ID之间用半角逗号（,）隔开，一次最多指定100个快照ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 's-Q2greuDZTvWeS8bfKZ**** '."\n" + .'或者["s-Q2greuDZTvWeS8bfKZ****","s-r4qlmevirw2vwmwv7*****"]'], ], [ 'name' => 'Force', 'in' => 'query', - 'schema' => [ - 'description' => '是否强制删除快照。'."\n" - ."\n" - .'默认值：false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'schema' => ['description' => '是否强制删除快照。'."\n" + ."\n" + .'默认值：false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], ], 'responses' => [ @@ -2784,85 +1190,37 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'ParameterEmpty.SnapshotId', - 'errorMessage' => 'The value of snapshotId is empty.', - ], - [ - 'errorCode' => 'ParameterExceed.SnapshotId', - 'errorMessage' => 'The maximum number of snapshot ID has been reached.', - ], - [ - 'errorCode' => 'ParameterInvalid.SnapshotId', - 'errorMessage' => 'The SnapshotId parameter is invalid.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'ParameterEmpty.SnapshotId', 'errorMessage' => 'The value of snapshotId is empty.', 'description' => '快照ID未填写。'], + ['errorCode' => 'ParameterExceed.SnapshotId', 'errorMessage' => 'The maximum number of snapshot ID has been reached.', 'description' => '快照ID数量超过最大值。'], + ['errorCode' => 'ParameterInvalid.SnapshotId', 'errorMessage' => 'The SnapshotId parameter is invalid.', 'description' => '快照id格式不规范。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.Snapshot', - 'errorMessage' => 'The snapshot does not exist.', - ], + ['errorCode' => 'EntityNotExist.Snapshot', 'errorMessage' => 'The snapshot does not exist.', 'description' => '快照不存在。'], ], 500 => [ - [ - 'errorCode' => 'SnapshotCreatedDbfs', - 'errorMessage' => 'A cloned DBFS exists under the current snapshot.', - ], + ['errorCode' => 'SnapshotCreatedDbfs', 'errorMessage' => 'A cloned DBFS exists under the current snapshot.', 'description' => '当前快照下存在克隆的DBFS。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteSnapshotResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DeleteSnapshotResponse>","errorExample":""}]', @@ -2876,17 +1234,26 @@ 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'ModifySnapshotAttribute' => [ - 'summary' => '修改一份快照的名称、描述。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}'], + ], + ], + ], ], + ], + 'DeleteTagsBatch' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -2895,148 +1262,91 @@ 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', + 'operationType' => 'delete', + 'abilityTreeCode' => '15805', + 'abilityTreeNodes' => ['FEATUREdbfsQMJ6C8'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'SnapshotId', - 'in' => 'query', - 'schema' => [ - 'description' => '快照ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 's-y2vZ3********vvMilZ2hQ', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'SnapshotName', + 'name' => 'DbfsList', 'in' => 'query', - 'schema' => [ - 'description' => '快照的显示名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以`http://`和`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。'."\n" - ."\n" - .'为防止和自动快照的名称冲突，不能以auto开头和dbfs-auto开头。', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'testSnapshotName', - ], + 'schema' => ['description' => '待删除标签的数据库文件系统实例列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '["dbfs-nUy1tb********BQ4X8Gpw","dbfs-v0WvA********tVEVcgJLg"]'], ], [ - 'name' => 'Description', + 'name' => 'Tags', 'in' => 'query', - 'schema' => [ - 'description' => '快照的描述。长度为2~256个英文或中文字符，不能以`http://`和`https://`开头。'."\n" - ."\n" - .'默认值：空。', - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => 'testDescription', - ], + 'schema' => ['description' => '待删除的标签列表。'."\n" + ."\n" + .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" + ."\n" + .'TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'ParameterInvalid.SnapshotDescription', - 'errorMessage' => 'The SnapshotDescription parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterInvalid.SnapshotName', - 'errorMessage' => 'The SnapshotName parameter is invalid.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.Snapshot', - 'errorMessage' => 'The snapshot does not exist.', + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteTagsBatchResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DeleteTagsBatchResponse>","errorExample":""}]', + 'title' => '批量删除标签', + 'summary' => '调用DeleteTagsBatch批量删除多个数据库文件系统实例的标签。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteTagsBatch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '修改快照属性', ], - 'ListSnapshot' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeDbfsSpecifications' => [ + 'summary' => '调用DescribeDbfsSpecifications查询DBFS的规格信息。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3046,548 +1356,147 @@ 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREdbfs9JXLXY'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '当前页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => false, - 'maximum' => '10240', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。'."\n" - ."\n" - .'最大值：100。'."\n" - ."\n" - .'默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'SortKey', - 'in' => 'query', - 'schema' => [ - 'description' => '查询快照时设置排序方式。'."\n" - ."\n" - .'与SortType配合使用，取值必须为SnapshotSize或CreatedTime。'."\n" - ."\n" - .'取值为SnapshotSize则根据快照容量排序，取值为CreatedTime则根据创建时间排序。'."\n" - ."\n" - .'默认根据创建时间倒序排列。', - 'type' => 'string', - 'required' => false, - 'example' => 'SnapshotSize', - ], - ], - [ - 'name' => 'SortType', - 'in' => 'query', - 'schema' => [ - 'description' => '查询快照时设置排序方式。'."\n" - ."\n" - .'与SortKey配合使用，取值必须为asc或desc。'."\n" - ."\n" - .'取值为asc则正序排列，取值为desc则降序排列。'."\n" - ."\n" - .'默认根据创建时间倒序排列。', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'asc' => 'asc', - 'desc' => 'desc', - ], - 'example' => 'desc', - ], - ], - [ - 'name' => 'FilterKey', - 'in' => 'query', - 'schema' => [ - 'description' => '查询快照时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为SnapshotId或SnapshotName。'."\n" - ."\n" - .'传入SnapshotId则根据快照ID进行筛选，传入SnapshotName则根据快照名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'SnapshotId', - ], - ], - [ - 'name' => 'FilterValue', - 'in' => 'query', - 'schema' => [ - 'description' => '查询快照时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 's-bp67acfmxazb4p****', - ], - ], - [ - 'name' => 'FsId', - 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs-GOrr********Yd0VLOyBpg', - ], - ], - [ - 'name' => 'Status', - 'in' => 'query', - 'schema' => [ - 'description' => '快照状态。取值范围：'."\n" - ."\n" - .'- progressing：正在创建的快照。'."\n" - ."\n" - .'- accomplished：创建成功的快照。'."\n" - ."\n" - .'- failed：创建失败的快照。'."\n" - ."\n" - .'- all（默认）：所有快照状态。', - 'type' => 'string', - 'required' => false, - 'example' => 'accomplished', - ], - ], - [ - 'name' => 'SnapshotName', - 'in' => 'query', - 'schema' => [ - 'description' => '快照名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'testSnapshotName', - ], - ], - [ - 'name' => 'SnapshotType', + 'name' => 'EcsInstanceType', 'in' => 'query', - 'schema' => [ - 'description' => '快照创建类型。目前仅支持手动快照。'."\n" - .' '."\n" - .'- user：手动创建快照。'."\n" - ."\n" - .'- all（默认）：所有的快照创建类型。'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'user', - ], + 'schema' => ['description' => 'ECS实例规格族。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'ecs.g7se'], ], [ - 'name' => 'SnapshotIds', + 'name' => 'Category', 'in' => 'query', - 'schema' => [ - 'description' => '快照标识编码。取值可以由多个快照ID组成一个JSON数组，最多支持100个ID，ID之间用半角逗号（,）隔开。', - 'type' => 'string', - 'required' => false, - 'example' => '["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", … "s-bp67acfmxazb6p****"]', - ], + 'schema' => ['description' => 'DBFS版本类型。取值范围：'."\n" + ."\n" + .'- standard'."\n" + ."\n" + .'- enterprise', 'type' => 'string', 'required' => true, 'example' => 'enterprise'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '32', - ], - 'PageSize' => [ - 'description' => '输入时设置的每页条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'PageNumber' => [ - 'description' => '当前页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'Snapshots' => [ - 'description' => '快照集合。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '187BCB3B-12E6-58B0-8E71-E19A895F49EF'], + 'SupportedEcsInstanceTypeFamily' => [ + 'description' => '支持的ECS实例规格族列表。', 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '快照状态。可能值：'."\n" - ."\n" - .'- progressing'."\n" - ."\n" - .'- accomplished'."\n" - ."\n" - .'- failed', - 'type' => 'string', - 'example' => 'accomplished', - ], - 'CreationTime' => [ - 'description' => '快照创建时间。', - 'type' => 'string', - 'example' => '1609330367000', - ], - 'Progress' => [ - 'description' => '快照进度。', - 'type' => 'string', - 'example' => '100%', - ], - 'SourceFsSize' => [ - 'description' => '源数据库文件系统容量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'RetentionDays' => [ - 'description' => '快照保留天数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'RemainTime' => [ - 'description' => '正在创建的快照剩余完成时间，单位为秒。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '38', - ], - 'LastModifiedTime' => [ - 'description' => '快照最后修改时间。', - 'type' => 'string', - 'example' => '1609330367000', - ], - 'SnapshotType' => [ - 'description' => '快照创建类型。可能值：'."\n" - ."\n" - .'- auto：自动创建快照。'."\n" - ."\n" - .'- user：手动创建快照。'."\n" - ."\n" - .'- all（默认）：所有的快照创建类型。', - 'type' => 'string', - 'example' => 'user', - ], - 'SnapshotName' => [ - 'description' => '快照显示名称。如果创建时指定了快照显示名称，则返回。', - 'type' => 'string', - 'example' => 'testSnapshotName', - ], - 'Description' => [ - 'description' => '快照描述。', - 'type' => 'string', - 'example' => 'testDescription', - ], - 'SourceFsId' => [ - 'description' => '源数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-bp67acfmxazb4p****', - ], - 'SnapshotId' => [ - 'description' => '快照ID。', - 'type' => 'string', - 'example' => 's-bp67acfmxazb4p****', - ], - 'Category' => [ - 'description' => '快照类型。可能值：'."\n" - ."\n" - .'- standard：标准版。'."\n" - ."\n" - .'- enterprise：企业版。', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'standard', - ], - 'SourceFsStripeWidth' => [ - 'description' => '源数据库文件系统条带宽度。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - ], - ], + 'items' => ['description' => 'ECS实例规格族。', 'type' => 'string', 'example' => '["ecs.g7se","ecs.r7se","ecs.c7se"]'], ], + 'MaxDbfsNumberPerEcs' => ['description' => '单台ECS最多支持挂载的DBFS实例数。', 'type' => 'object', 'example' => '{"enterprise": 4}'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"187BCB3B-12E6-58B0-8E71-E19A895F49EF\\",\\n \\"SupportedEcsInstanceTypeFamily\\": [\\n \\"[\\\\\\"ecs.g7se\\\\\\",\\\\\\"ecs.r7se\\\\\\",\\\\\\"ecs.c7se\\\\\\"]\\"\\n ],\\n \\"MaxDbfsNumberPerEcs\\": {\\n \\"enterprise\\": 4\\n },\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '查询DBFS规格信息', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-08-09T06:58:07.000Z', 'description' => 'OpenAPI 下线'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:DescribeDbfsSpecifications', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 32,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"Snapshots\\": [\\n {\\n \\"Status\\": \\"accomplished\\",\\n \\"CreationTime\\": \\"1609330367000\\",\\n \\"Progress\\": \\"100%\\",\\n \\"SourceFsSize\\": 20,\\n \\"RetentionDays\\": 30,\\n \\"RemainTime\\": 38,\\n \\"LastModifiedTime\\": \\"1609330367000\\",\\n \\"SnapshotType\\": \\"user\\",\\n \\"SnapshotName\\": \\"testSnapshotName\\",\\n \\"Description\\": \\"testDescription\\",\\n \\"SourceFsId\\": \\"dbfs-bp67acfmxazb4p****\\",\\n \\"SnapshotId\\": \\"s-bp67acfmxazb4p****\\",\\n \\"Category\\": \\"standard\\",\\n \\"SourceFsStripeWidth\\": 1\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TotalCount>32</TotalCount>\\n<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<PageSize>10</PageSize>\\n<PageNumber>1</PageNumber>\\n<Snapshots>\\n <Status>accomplished</Status>\\n <Progress>100%</Progress>\\n <Category>standard</Category>\\n <Description>testDescription</Description>\\n <RetentionDays>30</RetentionDays>\\n <SourceFsSize>20</SourceFsSize>\\n <SnapshotName>testSnapshotName</SnapshotName>\\n <SourceFsId>dbfs-bp67acfmxazb4p****</SourceFsId>\\n <SnapshotId>s-bp67acfmxazb4p****</SnapshotId>\\n <SourceFsStripeWidth>1</SourceFsStripeWidth>\\n <LastModifiedTime>1609330367000</LastModifiedTime>\\n <CreationTime>1609330367000</CreationTime>\\n <SnapshotType>user</SnapshotType>\\n <RemainTime>38</RemainTime>\\n</Snapshots>","errorExample":""}]', - 'title' => '查询快照', - 'summary' => '调用ListSnapshot查询用户创建的数据库文件系统快照列表。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], - 'GetSnapshotLink' => [ - 'summary' => '查询数据库文件系统快照链。快照链是一个数据库文件系统所有快照组成的关系链，一个文件系统对应一条快照链。', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DescribeInstanceTypes' => [ + 'summary' => '调用DescribeInstanceTypes查询DBFS支持的实例规格列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREdbfs29ABXP'], + 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'LinkId', - 'in' => 'query', - 'schema' => [ - 'description' => '快照链ID。', - 'type' => 'string', - 'required' => false, - 'example' => 'sl-b3zlgraysgcs9jy********', - ], + 'schema' => ['title' => '地域ID', 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'PlainResponse<AutoSnapshotPolicyViewModel>', - 'description' => 'PlainResponse<AutoSnapshotPolicyViewModel>', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'Data' => [ - 'description' => '自动快照策略详情。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'unattached 待挂载'."\n" - ."\n" - .'attached 已挂载'."\n" - ."\n" - .'creating 创建中'."\n" - ."\n" - .'attaching 挂载中'."\n" - ."\n" - .'detaching 卸载中'."\n" - ."\n" - .'deleting 删除中'."\n" - ."\n" - .'deleted 已删除'."\n" - ."\n" - .'resizing 扩容中'."\n" - ."\n" - .'snapshotting 快照中'."\n" - ."\n" - .'upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'TotalSize' => [ - 'description' => '快照链中所有快照的大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50331648', - ], - 'SourceSize' => [ - 'description' => '数据库文件系统容量，单位为GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'FsId' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-194j6u20sp2gisx*******', - ], - 'EcsList' => [ - 'description' => '挂载到的ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'description' => '已挂载的ECS实例。', - 'type' => 'object', - 'properties' => [ - 'EcsId' => [ - 'description' => '已挂载的ECS实例ID。', - 'type' => 'string', - 'example' => 'i-bp19mogqud1w1*******', - ], - ], - ], - ], - 'SnapshotCount' => [ - 'description' => '快照总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'FsName' => [ - 'description' => '数据库文件系统名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'LinkId' => [ - 'description' => '快照链ID。', - 'type' => 'string', - 'example' => 'sl-b3zlgraysgcs9jy*******', - ], - 'Category' => [ - 'description' => '数据库文件系统类型。取值范围：'."\n" - ."\n" - .'- standard：标准版'."\n" - ."\n" - .'- enterprise：企业版（公测中）', - 'type' => 'string', - 'example' => 'standard', + 'RequestId' => ['title' => 'Id of the request', 'description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'InstanceTypes' => [ + 'title' => 'Array of InstanceType', + 'description' => '实例规格列表。', + 'type' => 'array', + 'items' => [ + 'description' => '实例规格。', + 'type' => 'object', + 'properties' => [ + 'InstanceTypeId' => ['description' => '实例规格ID。', 'type' => 'string', 'example' => 'dbfs.small'], + 'CpuCoreCount' => ['description' => '最大CPU使用核数。', 'type' => 'number', 'format' => 'float', 'example' => '0.25'], + 'MemorySize' => ['description' => '最大内存占用（单位GiB）。', 'type' => 'number', 'format' => 'float', 'example' => '0.5'], + 'InstanceTypeDescription' => ['description' => '实例规格描述。', 'type' => 'string', 'example' => 'dbfs.small'], ], ], ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -3595,326 +1504,125 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 403 => [ - [ - 'errorCode' => 'PermissionDeny.SnapshotLink', - 'errorMessage' => 'The account has no permission on this snapshot link.', - ], - ], - [ - [ - 'errorCode' => 'SnapshotLinkNotFound', - 'errorMessage' => 'The snapshot link does not exist.', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"InstanceTypes\\": [\\n {\\n \\"InstanceTypeId\\": \\"dbfs.small\\",\\n \\"CpuCoreCount\\": 0.25,\\n \\"MemorySize\\": 0.5,\\n \\"InstanceTypeDescription\\": \\"dbfs.small\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '查询实例规格', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-10-26T08:58:40.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-10-26T08:39:42.000Z', 'description' => 'OpenAPI 下线'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:DescribeInstanceTypes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"Status\\": \\"attached\\",\\n \\"TotalSize\\": 50331648,\\n \\"SourceSize\\": 20,\\n \\"FsId\\": \\"dbfs-194j6u20sp2gisx*******\\",\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-bp19mogqud1w1*******\\"\\n }\\n ],\\n \\"SnapshotCount\\": 1,\\n \\"FsName\\": \\"test\\",\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\",\\n \\"Category\\": \\"standard\\"\\n },\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '获取单个快照链', ], - 'ListSnapshotLinks' => [ - 'summary' => '查询某个地域下满足条件的快照链。', - 'methods' => [ - 'get', - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'DetachDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '159557', - 'abilityTreeNodes' => [ - 'FEATUREdbfs3RTJEH', - ], - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ - 'name' => 'RegionId', - 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'PageNumber', - 'in' => 'query', - 'schema' => [ - 'description' => '当前页码。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => false, - 'maximum' => '999999', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - ], - [ - 'name' => 'PageSize', - 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。'."\n" - ."\n" - .'最大值：100。'."\n" - ."\n" - .'默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], - ], - [ - 'name' => 'FilterKey', - 'in' => 'query', - 'schema' => [ - 'description' => '查询快照链时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为LinkId或FsId。'."\n" - ."\n" - .'传入LinkId则根据快照链ID进行筛选，传入FsId则根据文件系统ID进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'FsId', - ], - ], - [ - 'name' => 'FilterValue', + 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '查询快照链时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'dbfs-kwziq4dpsle********', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'd-bp131n0q38u3a4zi*****'], ], [ - 'name' => 'FsIds', + 'name' => 'ECSInstanceId', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。一次最多指定100个文件系统ID。FsIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。', - 'type' => 'string', - 'required' => false, - 'example' => '["dbfs-kwziq4dpsle********","dbfs-vuaqvfcjqsg********"]', - ], + 'schema' => ['description' => '待卸载的ECS实例ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'i-bp67acfmxazb4ph***'], ], [ - 'name' => 'LinkIds', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '快照链ID。一次最多指定100个快照ID。LinkIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。', - 'type' => 'string', - 'required' => false, - 'example' => '["sl-bp1grgphbcc9brb5****","sl-bp1c4izumvq0i5bs****","sl-bp1akk7isz866dds****"]', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'PageSize' => [ - 'description' => '分页查询时设置的每页条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'PageNumber' => [ - 'description' => '当前页码。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'SnapshotLinks' => [ - 'description' => '快照链信息组成的集合。', - 'type' => 'array', - 'items' => [ - 'description' => '快照链信息。', - 'type' => 'object', - 'properties' => [ - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'- unattached 待挂载'."\n" - ."\n" - .'- attached 已挂载'."\n" - ."\n" - .'- creating 创建中'."\n" - ."\n" - .'- attaching 挂载中'."\n" - ."\n" - .'- detaching 卸载中'."\n" - ."\n" - .'- deleting 删除中'."\n" - ."\n" - .'- deleted 已删除'."\n" - ."\n" - .'- resizing 扩容中'."\n" - ."\n" - .'- snapshotting 快照中'."\n" - ."\n" - .'- upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'TotalSize' => [ - 'description' => '快照链中所有快照的大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => ' '."\n" - .'50331648', - ], - 'SourceSize' => [ - 'description' => '数据库文件系统容量，单位为GiB。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '20', - ], - 'FsId' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'example' => 'dbfs-q7qsgyqptjk******', - ], - 'EcsList' => [ - 'description' => '挂载到的ECS实例集合。', - 'type' => 'array', - 'items' => [ - 'description' => '已挂载的ECS。', - 'type' => 'object', - 'properties' => [ - 'EcsId' => [ - 'description' => '已挂载的ECS实例ID。', - 'type' => 'string', - 'example' => 'i-bp1f4eo2biro*******', - ], - ], - ], - ], - 'SnapshotCount' => [ - 'description' => '快照总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'FsName' => [ - 'description' => 'DBFS实例名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'LinkId' => [ - 'description' => '快照链ID', - 'type' => 'string', - 'example' => 'sl-b3zlgraysgcs9jy*******', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.ECS', 'errorMessage' => 'The ECS instance does not exist.', 'description' => 'ECS实例不存在。'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 10,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"SnapshotLinks\\": [\\n {\\n \\"Status\\": \\"attached\\",\\n \\"TotalSize\\": 50331648,\\n \\"SourceSize\\": 20,\\n \\"FsId\\": \\"dbfs-q7qsgyqptjk******\\",\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-bp1f4eo2biro*******\\"\\n }\\n ],\\n \\"SnapshotCount\\": 1,\\n \\"FsName\\": \\"test\\",\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '查询快照链', - 'description' => '调用该接口时，您需要注意：'."\n" - .'- 请求参数RegionId、FsIds、LinkIds等充当过滤器功能，参数间是逻辑与关系。'."\n" + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DetachDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DetachDbfsResponse>","errorExample":""}]', + 'title' => '卸载数据库文件系统', + 'summary' => '调用DetachDbfs从一台ECS实例上卸载一个按量付费的数据库文件系统。', + 'description' => '调用该接口时，请注意：'."\n" ."\n" - .'- 如果不指定任何参数，则过滤器不起作用。当FsIds和LinkIds为空数组时，相当于不进行过滤。', - ], - 'CreateAutoSnapshotPolicy' => [ - 'summary' => '在指定地域下创建一条自动快照策略。自动快照策略可以周期性地为数据库文件系统创建快照备份数据。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + .'- 数据库文件系统必须已经挂载到实例上，状态为已挂载（Attached)。'."\n" + ."\n" + .'- 卸载数据库文件系统时，所挂载的ECS实例必须处于运行中（Running）或者已停止（Stopped）状态。'."\n" + ."\n" + .'- DetachDbfs是异步操作，调用接口成功后等待一分钟左右才能完成卸载。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:DetachDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'GetAutoSnapshotPolicy' => [ + 'summary' => '查询单个自动快照策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -3922,197 +1630,111 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'abilityTreeCode' => '150683', - 'abilityTreeNodes' => [ - 'FEATUREdbfsOC34E7', - ], - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'PolicyName', - 'in' => 'query', - 'schema' => [ - 'title' => '自动快照策略名称', - 'description' => '策略名称。', - 'type' => 'string', - 'required' => true, - 'example' => 'policyTest', - ], - ], - [ - 'name' => 'RetentionDays', - 'in' => 'query', - 'schema' => [ - 'title' => '保留天数', - 'description' => '保留天数。', - 'type' => 'integer', - 'format' => 'int32', - 'deprecated' => false, - 'required' => true, - 'maximum' => '65536', - 'minimum' => '-1', - 'example' => '30', - ], - ], - [ - 'name' => 'RepeatWeekdays', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'title' => '重复星期', - 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" - ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" - ."\n" - .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的重复日期，周期为星期。', - 'type' => 'string', - 'required' => true, - 'example' => '"1"', - ], - 'required' => true, - 'maxItems' => 7, - 'minItems' => 1, - ], - ], - [ - 'name' => 'TimePoints', + 'name' => 'PolicyId', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'title' => '重复时间', - 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" - ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" - ."\n" - .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的创建时间点。', - 'type' => 'string', - 'required' => true, - 'example' => '"01"', - ], - 'required' => true, - 'maxItems' => 24, - 'minItems' => 1, - ], + 'schema' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'PlainResponse<AutoSnapshotPolicyViewModel>', 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'PolicyId' => [ - 'description' => '自动快照策略ID', - 'type' => 'string', - 'example' => 'sp-z5siir3iq3m**********', - ], - 'AccessDeniedDetail' => [ + 'Data' => [ + 'description' => '自动快照策略详情。', 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', + 'PolicyId' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'example' => 'sp-z5siir3iq3m**********'], + 'PolicyName' => ['title' => '自动快照策略名称', 'description' => '自动快照策略名称。', 'type' => 'string', 'example' => 'PolicyTest'], + 'AccountId' => ['title' => '账户ID', 'description' => '账户ID。', 'type' => 'string', 'example' => '13523459********'], + 'RegionId' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'Status' => ['title' => '策略状态', 'description' => '策略状态。', 'type' => 'string', 'example' => 'Normal'], + 'StatusDetail' => ['description' => '若出现异常的状态信息详情，status为normal时为空。', 'type' => 'string', 'example' => '-'], + 'RetentionDays' => ['title' => '快照保留天数（1-65535，NULL为永久保存）', 'description' => '快照保留天数（1-65535，-1为持续保留，直至快照数量达到额度上限后被自动删除）。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'AppliedDbfsNumber' => ['title' => '设置的dbfs数', 'description' => '设置该自动快照策略的数据库文件系统数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RepeatWeekdays' => [ + 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + ."\n" + .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的重复日期，周期为星期。', 'type' => 'string', 'example' => '"1"'], ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', + 'TimePoints' => [ + 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" + ."\n" + .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的创建时间点。', 'type' => 'string', 'example' => '"01"'], ], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '1670998784000'], + 'LastModified' => ['description' => '最后修改时间。', 'type' => 'string', 'example' => '1670998784000'], ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'AccessDeniedDetail' => [ + 'type' => 'object', + 'properties' => [ + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], + ], + 'description' => '', + ], ], ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterInvalid.RetentionDays', - 'errorMessage' => 'The RetentionDays parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterInvalid.RepeatWeekDays', - 'errorMessage' => 'The RepeatWeekdays parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterInvalid.TimePoints', - 'errorMessage' => 'The TimePoints parameter is invalid.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'ParameterInvalid.PolicyName', - 'errorMessage' => 'The PolicyName parameter is invalid.', + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + [ + ['errorCode' => 'PermissionDeny.Policy', 'errorMessage' => 'The account has no permission on this policy.', 'description' => ''], + ], + 404 => [ + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\",\\n \\"PolicyName\\": \\"PolicyTest\\",\\n \\"AccountId\\": \\"13523459********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Status\\": \\"Normal\\",\\n \\"StatusDetail\\": \\"-\\",\\n \\"RetentionDays\\": 30,\\n \\"AppliedDbfsNumber\\": 1,\\n \\"RepeatWeekdays\\": [\\n \\"\\\\\\"1\\\\\\"\\"\\n ],\\n \\"TimePoints\\": [\\n \\"\\\\\\"01\\\\\\"\\"\\n ],\\n \\"CreatedTime\\": \\"1670998784000\\",\\n \\"LastModified\\": \\"1670998784000\\"\\n },\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '查询单个自动快照策略', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '创建自动快照策略', - 'description' => '数据库文件系统快照基于云盘快照，由云盘进行快照扣费。请确保在使用该接口前，已充分了解云盘快照的收费方式和[价格](https://help.aliyun.com/document_detail/56159.htm?spm=a2c4g.11186623.0.0.19dd5496Onr9aK#concept-rq2-pcx-ydb)。', ], - 'CancelAutoSnapshotPolicy' => [ - 'summary' => '取消一个或多个数据库文件系统的自动快照策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'GetDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4120,151 +1742,203 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'PolicyId', - 'in' => 'query', - 'schema' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], - ], - [ - 'name' => 'DbfsIds', + 'name' => 'RegionId', 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '传入的需要取消该自动快照策略的数据库文件系统列表，传入的参数需要保持JSON数组格式，ID之间用半角逗号（,）隔开。例如：["dbfs-1luaxt4vs1iusrd`*******`","dbfs-cxbyu98fspcbvm`******`"]。', - 'type' => 'array', - 'items' => [ - 'description' => '传入的需要取消该自动快照策略的数据库文件系统。', - 'type' => 'string', - 'required' => true, - 'example' => '"dbfs-1luaxt4vs1iusrd*******"', - ], - 'required' => true, - 'minItems' => 1, - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'RegionId', + 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'AccessDeniedDetail' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'DBFSInfo' => [ + 'description' => '数据库文件系统实例。', 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', + 'Status' => ['description' => '数据库文件系统的状态。'."\n" + ."\n" + .'取值范围：'."\n" + ."\n" + .'- unattached 待挂载'."\n" + ."\n" + .'- attached 已挂载'."\n" + ."\n" + .'- creating 创建中'."\n" + ."\n" + .'- attaching 挂载中'."\n" + ."\n" + .'- detaching 卸载中'."\n" + ."\n" + .'- deleting 删除中'."\n" + ."\n" + .'- deleted 已删除'."\n" + ."\n" + .'- resizing 扩容中'."\n" + ."\n" + .'- snapshotting 快照中'."\n" + ."\n" + .'- upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'PayType' => ['description' => '数据库文件系统的付费类型，目前仅支持按量付费（postpaid）。', 'type' => 'string', 'example' => 'postpaid'], + 'FsId' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + 'Tags' => [ + 'description' => '标签集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TagValue' => ['description' => '标签值。', 'type' => 'string', 'example' => 'TestTagValue1'], + 'Id' => ['description' => '标签ID。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'TagKey' => ['description' => '标签键。', 'type' => 'string', 'example' => 'TestTagKey1'], + ], + 'description' => '', + ], ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', + 'SizeG' => ['description' => '数据库文件系统大小，单位GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'EcsList' => [ + 'description' => '挂载到的ECS实例集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'EcsId' => ['description' => '已挂载的ECS实例ID。', 'type' => 'string', 'example' => 'i-y2vZ3********vvMilZ2hQ'], + ], + 'description' => '', + ], ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', + 'RegionId' => ['description' => '数据库文件系统所属的地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'DBFSClusterId' => ['description' => '数据库文件系统集群ID。', 'type' => 'string', 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD'], + 'Description' => ['description' => '数据库文件系统描述信息。', 'type' => 'string', 'example' => 'desc'], + 'ZoneId' => ['description' => '数据库文件系统所属的可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-i'], + 'FsName' => ['description' => '数据库文件系统名称。', 'type' => 'string', 'example' => 'dbfs-test-01'], + 'Category' => ['description' => '数据库文件系统类型。取值范围：'."\n" + ."\n" + .'- standard：标准版'."\n" + ."\n" + .'- enterprise：企业版（公测中）', 'type' => 'string', 'example' => 'standard'], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '1609330367000'], + 'AttachNodeNumber' => ['description' => '数据库文件系统挂载的节点数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'KMSKeyId' => ['description' => 'KMS密钥ID。', 'type' => 'string', 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4D******'], + 'Encryption' => ['description' => '是否已加密。', 'type' => 'boolean', 'example' => 'false'], + 'PerformanceLevel' => ['description' => '云盘性能等级。取值范围：'."\n" + ."\n" + .'- PL0'."\n" + ."\n" + .'- PL1'."\n" + ."\n" + .'- PL2'."\n" + ."\n" + .'- PL3', 'type' => 'string', 'example' => 'PL1'], + 'UsedScene' => ['description' => '使用场景。', 'type' => 'string', 'example' => 'MySQL 5.7'], + 'LastMountTime' => ['description' => '最后挂载时间。', 'type' => 'string', 'example' => '1644915400000'], + 'LastUmountTime' => ['description' => '最后卸载时间。', 'type' => 'string', 'example' => '1644915319000'], + 'EnableRaid' => ['description' => '是否使能RAID。', 'type' => 'boolean', 'example' => 'false'], + 'InstanceType' => ['description' => 'DBFS实例规格。取值范围：'."\n" + ."\n" + .'- dbfs.small'."\n" + ."\n" + .'- dbfs.medium'."\n" + ."\n" + .'- dbfs.large', 'type' => 'string', 'example' => 'dbfs.small'], + 'RaidStrip' => ['description' => '条数个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'EbsList' => [ + 'description' => 'DBFS使用的云盘列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'EbsId' => ['description' => '云盘ID。', 'type' => 'string', 'example' => 'd-bp1hq4******qi7gy1th'], + 'SizeG' => ['description' => '云盘容量。单位GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + ], + 'description' => '', + ], ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', + 'LastFailed' => ['description' => '最近一次操作失败原因。', 'type' => 'string', 'example' => 'TargetIsBusy.DBFS'], + 'SnapshotInfo' => [ + 'description' => '快照相关信息。', + 'type' => 'object', + 'properties' => [ + 'SnapshotCount' => ['description' => '快照数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'LinkId' => ['description' => '快照链id，若没有快照链则为“-”。', 'type' => 'string', 'example' => 'sl-9zskwvgoqqqvzxa*******'], + 'TotalSize' => ['description' => '快照容量。', 'type' => 'integer', 'format' => 'int64', 'example' => '50331648'], + 'PolicyId' => ['description' => '自动快照策略id，若没有设置自动快照策略则为“-”。', 'type' => 'string', 'example' => 'sp-ehuhzlfetb2jiwz*******'], + ], ], + 'AdvancedFeatures' => ['description' => '数据库文件存储实例使用的CPU核数、内存上限值等。'."\n" + ."\n" + .'- cpuCoreCount：CPU核数。'."\n" + .'- memorySize：内存大小，单位MB。'."\n" + .'- pageCacheSize：PageCache缓存大小，单位MB。', 'type' => 'string', 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}'], + 'SnapshotId' => ['description' => '创建DBFS实例使用的快照ID。', 'type' => 'string', 'example' => 's-uvwtoxcjj6xtlua*******'], + ], + ], + 'AccessDeniedDetail' => [ + 'type' => 'object', + 'properties' => [ + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'DbfsWithAutoSnapshotPolicy.NotFound', - 'errorMessage' => 'Dbfs cancel failed.The specified dbfs does not apply this auto snapshot policy or does not exist.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'ParameterEmpty.PolicyId', - 'errorMessage' => 'The value of policyId is empty.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], 404 => [ - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', - ], + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.(EntityNotExist.DBFS)', 'description' => '数据库文件存储实例不存在。'], ], - 409 => [ - [ - 'errorCode' => 'OperationConflict', - 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', - ], - ], - 503 => [ - [ - 'errorCode' => 'AutoShapshotBusy', - 'errorMessage' => 'The server is busy now, please try again later.', + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DBFSInfo\\": {\\n \\"Status\\": \\"attached\\",\\n \\"PayType\\": \\"postpaid\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"Tags\\": [\\n {\\n \\"TagValue\\": \\"TestTagValue1\\",\\n \\"Id\\": 1,\\n \\"TagKey\\": \\"TestTagKey1\\"\\n }\\n ],\\n \\"SizeG\\": 20,\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-y2vZ3********vvMilZ2hQ\\"\\n }\\n ],\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBFSClusterId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD\\",\\n \\"Description\\": \\"desc\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"FsName\\": \\"dbfs-test-01\\",\\n \\"Category\\": \\"standard\\",\\n \\"CreatedTime\\": \\"1609330367000\\",\\n \\"AttachNodeNumber\\": 1,\\n \\"KMSKeyId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4D******\\",\\n \\"Encryption\\": false,\\n \\"PerformanceLevel\\": \\"PL1\\",\\n \\"UsedScene\\": \\"MySQL 5.7\\",\\n \\"LastMountTime\\": \\"1644915400000\\",\\n \\"LastUmountTime\\": \\"1644915319000\\",\\n \\"EnableRaid\\": false,\\n \\"InstanceType\\": \\"dbfs.small\\",\\n \\"RaidStrip\\": 2,\\n \\"EbsList\\": [\\n {\\n \\"EbsId\\": \\"d-bp1hq4******qi7gy1th\\",\\n \\"SizeG\\": 20\\n }\\n ],\\n \\"LastFailed\\": \\"TargetIsBusy.DBFS\\",\\n \\"SnapshotInfo\\": {\\n \\"SnapshotCount\\": 1,\\n \\"LinkId\\": \\"sl-9zskwvgoqqqvzxa*******\\",\\n \\"TotalSize\\": 50331648,\\n \\"PolicyId\\": \\"sp-ehuhzlfetb2jiwz*******\\"\\n },\\n \\"AdvancedFeatures\\": \\"{\\\\\\"cpuCoreCount\\\\\\":0.5,\\\\\\"memorySize\\\\\\":512,\\\\\\"pageCacheSize\\\\\\":128}\\",\\n \\"SnapshotId\\": \\"s-uvwtoxcjj6xtlua*******\\"\\n },\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<DBFSInfo>\\n <Status>attached</Status>\\n <LastFailed>TargetIsBusy.DBFS</LastFailed>\\n <KMSKeyId>c39EcDBf-2Ecb-C3C6-6526-018d4D******</KMSKeyId>\\n <CreatedTime>1609330367000</CreatedTime>\\n <Category>standard</Category>\\n <Description>desc</Description>\\n <EnableRaid>false</EnableRaid>\\n <ZoneId>cn-hangzhou-i</ZoneId>\\n <SizeG>20</SizeG>\\n <PerformanceLevel>PL1</PerformanceLevel>\\n <DBFSClusterId>c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD</DBFSClusterId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n <LastUmountTime>1644915319000</LastUmountTime>\\n <Encryption>false</Encryption>\\n <PayType>postpaid</PayType>\\n <FsName>dbfs-test-01</FsName>\\n <UsedScene>MySQL 5.7</UsedScene>\\n <RaidStrip>2</RaidStrip>\\n <LastMountTime>1644915400000</LastMountTime>\\n <AttachNodeNumber>1</AttachNodeNumber>\\n <RegionId>cn-hangzhou</RegionId>\\n <InstanceType>dbfs.small</InstanceType>\\n <EcsList>\\n <EcsId>i-y2vZ3********vvMilZ2hQ</EcsId>\\n </EcsList>\\n <EbsList>\\n <SizeG>20</SizeG>\\n <EbsId>d-bp1hq4******qi7gy1th</EbsId>\\n </EbsList>\\n <Tags>\\n <TagKey>TestTagKey1</TagKey>\\n <Id>1</Id>\\n <TagValue>TestTagValue1</TagValue>\\n </Tags>\\n</DBFSInfo>","errorExample":""}]', + 'title' => '查询单个数据库文件系统', + 'summary' => '调用GetDbfs查询数据库文件系统详细信息。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-11-07T11:56:27.000Z', 'description' => '错误码发生变更、响应参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-01-04T03:07:11.000Z', 'description' => '响应参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-01-03T02:42:12.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-01-19T07:16:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-10-27T06:07:17.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-05-19T11:19:18.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '取消自动快照策略', ], - 'ApplyAutoSnapshotPolicy' => [ - 'summary' => '为一个或多个数据库文件系统设置自动快照策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'GetServiceLinkedRole' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4272,256 +1946,172 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => [ + 'operationType' => 'get', + 'abilityTreeCode' => '15808', + 'abilityTreeNodes' => ['FEATUREdbfs29ABXP'], + ], 'parameters' => [ [ - 'name' => 'PolicyId', - 'in' => 'query', - 'schema' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], - ], - [ - 'name' => 'DbfsIds', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '传入的需要设置该自动快照策略的数据库文件系统ID列表，传入的参数需要保持JSON数组格式，ID之间用半角逗号（,）隔开。例如：["dbfs-1luaxt4vs1iusrd`*******`", "dbfs-cxbyu98fspcbvm`******`“]。', - 'type' => 'array', - 'items' => [ - 'description' => '需要设置该自动快照策略的数据库文件系统。', - 'type' => 'string', - 'required' => true, - 'example' => '"dbfs-1luaxt4vs1iusrd*******"', - ], - 'required' => true, - 'minItems' => 1, - ], - ], - [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'AccountId' => ['description' => '主账号ID。', 'type' => 'string', 'example' => '1352345930******'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'DbfsLinkedRole' => ['description' => '是否已创建服务关联角色。'."\n" + ."\n" + .'- true: 已创建'."\n" + ."\n" + .'- false: 未创建', 'type' => 'boolean', 'example' => 'true'], + 'RegionId' => ['description' => '地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterInvalid.DbfsIds', - 'errorMessage' => 'The DbfsIds parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterEmpty.PolicyId', - 'errorMessage' => 'The value of policyId is empty.', - ], - [ - 'errorCode' => 'DbfsAlreadyAppliedAutoSnapshotPolicy', - 'errorMessage' => 'An automatic snapshot policy has been applied on the specified dbfs.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - ], - [ - [ - 'errorCode' => 'PermissionDeny.Policy', - 'errorMessage' => 'The account has no permission on this policy.', - ], - [ - 'errorCode' => 'PermissionDeny.DBFS', - 'errorMessage' => 'The account has no permission on this DBFS.', - ], - ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 409 => [ - [ - 'errorCode' => 'OperationConflict', - 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', - ], + 403 => [ + ['errorCode' => 'PermissionDeny.DBFS', 'errorMessage' => 'RAM permission verification failed.', 'description' => '账户 RAM 权限校验失败。'], ], - 503 => [ - [ - 'errorCode' => 'AutoShapshotBusy', - 'errorMessage' => 'The server is busy now, please try again later.', + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"AccountId\\": \\"1352345930******\\",\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsLinkedRole\\": true,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetServiceLinkedRoleResponse>\\n <AccountId>1352345930******</AccountId>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <DbfsLinkedRole>true</DbfsLinkedRole>\\n <RegionId>cn-hangzhou</RegionId>\\n</GetServiceLinkedRoleResponse>","errorExample":""}]', + 'title' => '查询服务关联角色', + 'summary' => '调用GetServiceLinkedRole查询用户是否已经创建过服务关联角色。', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '错误码发生变更、响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetServiceLinkedRole', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '设置自动快照策略', - 'description' => '- 一个文件系统只能设置一条自动快照策略。若需要更换策略，请先取消原自动快照策略。'."\n" - .'- 一条自动快照策略支持应用到多个文件系统。'."\n" - ."\n" - .'数据库文件系统快照基于云盘快照，由云盘进行快照扣费。请确保在使用该接口前，已充分了解云盘快照的收费方式和[价格](https://help.aliyun.com/document_detail/56159.htm?spm=openapi-amp.newDocPublishment.0.0.4ada281fa5jFc7#concept-rq2-pcx-ydb)。', ], - 'DeleteAutoSnapshotPolicy' => [ - 'summary' => '删除一条自动快照策略。删除后，已经设置了该自动快照策略的文件系统将自动取消策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'https', - 'http', - ], + 'GetSnapshotLink' => [ + 'summary' => '查询数据库文件系统快照链。快照链是一个数据库文件系统所有快照组成的关系链，一个文件系统对应一条快照链。', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ - 'name' => 'PolicyId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'RegionId', + 'name' => 'LinkId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '快照链ID。', 'type' => 'string', 'required' => false, 'example' => 'sl-b3zlgraysgcs9jy********'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ - 'title' => 'BaseResponse', - 'description' => '返回结果。', + 'title' => 'PlainResponse<AutoSnapshotPolicyViewModel>', + 'description' => 'PlainResponse<AutoSnapshotPolicyViewModel>', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC********', + 'Data' => [ + 'description' => '自动快照策略详情。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '数据库文件系统的状态。'."\n" + ."\n" + .'取值范围：'."\n" + ."\n" + .'unattached 待挂载'."\n" + ."\n" + .'attached 已挂载'."\n" + ."\n" + .'creating 创建中'."\n" + ."\n" + .'attaching 挂载中'."\n" + ."\n" + .'detaching 卸载中'."\n" + ."\n" + .'deleting 删除中'."\n" + ."\n" + .'deleted 已删除'."\n" + ."\n" + .'resizing 扩容中'."\n" + ."\n" + .'snapshotting 快照中'."\n" + ."\n" + .'upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'TotalSize' => ['description' => '快照链中所有快照的大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '50331648'], + 'SourceSize' => ['description' => '数据库文件系统容量，单位为GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'FsId' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-194j6u20sp2gisx*******'], + 'EcsList' => [ + 'description' => '挂载到的ECS实例集合。', + 'type' => 'array', + 'items' => [ + 'description' => '已挂载的ECS实例。', + 'type' => 'object', + 'properties' => [ + 'EcsId' => ['description' => '已挂载的ECS实例ID。', 'type' => 'string', 'example' => 'i-bp19mogqud1w1*******'], + ], + ], + ], + 'SnapshotCount' => ['description' => '快照总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'FsName' => ['description' => '数据库文件系统名称。', 'type' => 'string', 'example' => 'test'], + 'LinkId' => ['description' => '快照链ID。', 'type' => 'string', 'example' => 'sl-b3zlgraysgcs9jy*******'], + 'Category' => ['description' => '数据库文件系统类型。取值范围：'."\n" + ."\n" + .'- standard：标准版'."\n" + ."\n" + .'- enterprise：企业版（公测中）', 'type' => 'string', 'example' => 'standard'], + ], ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -4529,53 +2119,38 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'ParameterEmpty.PolicyId', - 'errorMessage' => 'The value of policyId is empty.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - ], - [ - [ - 'errorCode' => 'PermissionDeny.Policy', - 'errorMessage' => 'The account has no permission on this policy.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 404 => [ - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', - ], + 403 => [ + ['errorCode' => 'PermissionDeny.SnapshotLink', 'errorMessage' => 'The account has no permission on this snapshot link.', 'description' => '没有操作该快照链的权限。'], ], - 409 => [ - [ - 'errorCode' => 'OperationConflict', - 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', - ], + [ + ['errorCode' => 'SnapshotLinkNotFound', 'errorMessage' => 'The snapshot link does not exist.', 'description' => '该快照链不存在。'], ], - 503 => [ - [ - 'errorCode' => 'AutoShapshotBusy', - 'errorMessage' => 'The server is busy now, please try again later.', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"Status\\": \\"attached\\",\\n \\"TotalSize\\": 50331648,\\n \\"SourceSize\\": 20,\\n \\"FsId\\": \\"dbfs-194j6u20sp2gisx*******\\",\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-bp19mogqud1w1*******\\"\\n }\\n ],\\n \\"SnapshotCount\\": 1,\\n \\"FsName\\": \\"test\\",\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\",\\n \\"Category\\": \\"standard\\"\\n },\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '获取单个快照链', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetSnapshotLink', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC********\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '删除自动快照策略', ], - 'ModifyAutoSnapshotPolicy' => [ - 'summary' => '修改一条自动快照策略。修改自动快照策略后，之前已设置该策略的数据库文件系统随即执行修改后的自动快照策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListAutoSnapshotPolicies' => [ + 'summary' => '查询您在某个地域下，所有已创建的符合查询条件的自动快照策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4583,216 +2158,153 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREdbfsOC34E7'], + 'tenantRelevance' => 'publicInformation', + ], 'parameters' => [ [ - 'name' => 'PolicyId', + 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'title' => '策略ID', - 'description' => '策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'PolicyName', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'title' => '策略名称', - 'description' => '策略名称。', - 'type' => 'string', - 'required' => false, - 'example' => 'policyTest', - ], + 'schema' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '999999', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ - 'name' => 'RetentionDays', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'title' => '保留天数', - 'description' => '保留天数。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '65536', - 'minimum' => '-1', - 'example' => '30', - ], + 'schema' => ['description' => '分页查询时设置的每页条数。默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '10', 'example' => '10', 'default' => '10'], ], [ - 'name' => 'RepeatWeekdays', + 'name' => 'FilterKey', 'in' => 'query', - 'style' => 'json', 'schema' => [ - 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" + 'description' => '查询资源时的筛选键。'."\n" ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + .'与FilterValue配合使用，取值必须为PolicyId或PolicyName。'."\n" ."\n" - .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的重复日期。', - 'type' => 'string', - 'required' => false, - 'example' => '"1"', - ], - 'required' => false, - 'maxItems' => 7, - ], - ], - [ - 'name' => 'TimePoints', - 'in' => 'query', - 'style' => 'json', - 'schema' => [ - 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" - .'传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" - .'当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的创建时间点。', - 'type' => 'string', - 'required' => false, - 'example' => '"01"', - ], + .'传入PolicyId则根据自动快照策略ID进行筛选，传入PolicyName则根据自动快照策略名称进行筛选。', + 'type' => 'string', 'required' => false, - 'maxItems' => 24, + 'example' => 'PolicyName', + 'enum' => ['PolicyId', 'PolicyName'], ], ], [ - 'name' => 'RegionId', + 'name' => 'FilterValue', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '查询自动快照策略时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'policyTest'], ], ], 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'PlainResponse<PageResponse<AutoSnapshotPolicyViewModel>>', 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', + 'PageNumber' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '分页查询时设置的每页条数。默认值：10。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '自动快照策略的总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'SnapshotPolicies' => [ + 'description' => '自动快照策略详情列表。', + 'type' => 'array', + 'items' => [ + 'description' => '自动快照策略信息详情。', + 'type' => 'object', + 'properties' => [ + 'PolicyId' => ['title' => '策略ID', 'description' => '自动快照策略ID。', 'type' => 'string', 'example' => 'sp-z5siir3iq3m**********'."\n"], + 'PolicyName' => ['title' => '自动快照策略名称', 'description' => '自动快照策略名称。', 'type' => 'string', 'example' => 'policyTest'], + 'AccountId' => ['title' => '账户ID', 'description' => '账户ID。', 'type' => 'string', 'example' => '13523459********'], + 'RegionId' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'Status' => [ + 'title' => '策略状态', + 'description' => '策略状态。', + 'type' => 'string', + 'enumValueTitles' => ['normal' => 'normal', 'abnormal' => 'abnormal'], + 'example' => 'normal', + ], + 'StatusDetail' => ['description' => '若出现异常的状态信息详情，status为normal时为空。', 'type' => 'string', 'example' => '-'], + 'RetentionDays' => ['title' => '快照保留天数（1-65535，NULL为永久保存）', 'description' => '快照保留天数（1-65535，NULL为持续保存，直至快照数量达到额度上限后被自动删除）。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'AppliedDbfsNumber' => ['title' => '设置的dbfs数', 'description' => '设置该自动快照策略的数据库文件系统数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RepeatWeekdays' => [ + 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + ."\n" + .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的重复日期，周期为星期。', 'type' => 'string', 'example' => '"1"'], + ], + 'TimePoints' => [ + 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" + ."\n" + .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的创建时间点。', 'type' => 'string', 'example' => ' "01"'], + ], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '1670998784000'], + 'LastModified' => ['description' => '最后修改时间。', 'type' => 'string', 'example' => '1670998784000'], + ], + ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterInvalid.RetentionDays', - 'errorMessage' => 'The RetentionDays parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterInvalid.RepeatWeekDays', - 'errorMessage' => 'The RepeatWeekdays parameter is invalid.', - ], - [ - 'errorCode' => 'ParameterInvalid.TimePoints', - 'errorMessage' => 'The TimePoints parameter is invalid.', - ], - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - [ - 'errorCode' => 'ParameterEmpty.PolicyId', - 'errorMessage' => 'The value of policyId is empty.', - ], - [ - 'errorCode' => 'ParameterInvalid.PolicyName', - 'errorMessage' => 'The PolicyName parameter is invalid.', - ], - ], - [ - [ - 'errorCode' => 'PermissionDeny.Policy', - 'errorMessage' => 'The account has no permission on this policy.', - ], - ], 404 => [ - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', - ], - ], - 409 => [ - [ - 'errorCode' => 'OperationConflict', - 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', - ], + ['errorCode' => 'InvalidRegionId.NotFound', 'errorMessage' => 'The specified RegionId does not exist.', 'description' => '指定的地域 ID 不存在。'], ], - 503 => [ - [ - 'errorCode' => 'AutoShapshotBusy', - 'errorMessage' => 'The server is busy now, please try again later.', + ], + 'staticInfo' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"SnapshotPolicies\\": [\\n {\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\\\n\\",\\n \\"PolicyName\\": \\"policyTest\\",\\n \\"AccountId\\": \\"13523459********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Status\\": \\"normal\\",\\n \\"StatusDetail\\": \\"-\\",\\n \\"RetentionDays\\": 30,\\n \\"AppliedDbfsNumber\\": 1,\\n \\"RepeatWeekdays\\": [\\n \\"\\\\\\"1\\\\\\"\\"\\n ],\\n \\"TimePoints\\": [\\n \\" \\\\\\"01\\\\\\"\\"\\n ],\\n \\"CreatedTime\\": \\"1670998784000\\",\\n \\"LastModified\\": \\"1670998784000\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '列出自动快照策略', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicies', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '修改自动快照策略', ], - 'GetAutoSnapshotPolicy' => [ - 'summary' => '查询单个自动快照策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListAutoSnapshotPolicyAppliedDbfs' => [ + 'summary' => '查询所有已设置该自动快照策略的数据库文件系统列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -4800,174 +2312,114 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ 'name' => 'PolicyId', 'in' => 'query', - 'schema' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], + 'schema' => ['description' => '自动快照策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ - 'name' => 'RegionId', + 'name' => 'PageNumber', + 'in' => 'query', + 'schema' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '999999', 'minimum' => '1', 'example' => '1', 'default' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '分页查询时设置的每页条数。默认值10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '10', 'example' => '10', 'default' => '10'], + ], + [ + 'name' => 'FilterKey', 'in' => 'query', 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', + 'description' => '查询资源时的筛选键。'."\n" + ."\n" + .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" + ."\n" + .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + 'required' => false, + 'example' => 'FsName', + 'enum' => ['FsId', 'FsName'], ], ], + [ + 'name' => 'FilterValue', + 'in' => 'query', + 'schema' => ['description' => '查询资源时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'DBFS1'], + ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ - 'title' => 'PlainResponse<AutoSnapshotPolicyViewModel>', + 'title' => 'PlainResponse<PageResponse<DbfsOnAutoSnapshotPolicyViewModel>>', 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'Data' => [ - 'description' => '自动快照策略详情。', - 'type' => 'object', - 'properties' => [ - 'PolicyId' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'example' => 'sp-z5siir3iq3m**********', - ], - 'PolicyName' => [ - 'title' => '自动快照策略名称', - 'description' => '自动快照策略名称。', - 'type' => 'string', - 'example' => 'PolicyTest', - ], - 'AccountId' => [ - 'title' => '账户ID', - 'description' => '账户ID。', - 'type' => 'string', - 'example' => '13523459********', - ], - 'RegionId' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'Status' => [ - 'title' => '策略状态', - 'description' => '策略状态。', - 'type' => 'string', - 'example' => 'Normal', - ], - 'StatusDetail' => [ - 'description' => '若出现异常的状态信息详情，status为normal时为空。', - 'type' => 'string', - 'example' => '-', - ], - 'RetentionDays' => [ - 'title' => '快照保留天数（1-65535，NULL为永久保存）', - 'description' => '快照保留天数（1-65535，-1为持续保留，直至快照数量达到额度上限后被自动删除）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'AppliedDbfsNumber' => [ - 'title' => '设置的dbfs数', - 'description' => '设置该自动快照策略的数据库文件系统数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RepeatWeekdays' => [ - 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" + 'PageNumber' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '分页查询时设置的每页条数。默认值10。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'DbfsList' => [ + 'description' => '已设置该自动快照策略的DBFS列表。', + 'type' => 'array', + 'items' => [ + 'description' => '已设置该自动快照策略的DBFS。', + 'type' => 'object', + 'properties' => [ + 'FsId' => ['title' => 'DBFS实例ID', 'description' => 'DBFS实例ID。', 'type' => 'string', 'example' => 'dbfs-ejdvesb0qvuywvg*******'], + 'FsName' => ['title' => 'DBFS实例名称', 'description' => 'DBFS实例名称。', 'type' => 'string', 'example' => 'test'], + 'Status' => ['description' => '数据库文件系统的状态。'."\n" ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + .'取值范围：'."\n" ."\n" - .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的重复日期，周期为星期。', - 'type' => 'string', - 'example' => '"1"', - ], - ], - 'TimePoints' => [ - 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" + .'- unattached 待挂载'."\n" ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" + .'- attached 已挂载'."\n" ."\n" - .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的创建时间点。', - 'type' => 'string', - 'example' => '"01"', - ], - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '1670998784000', - ], - 'LastModified' => [ - 'description' => '最后修改时间。', - 'type' => 'string', - 'example' => '1670998784000', + .'- creating 创建中'."\n" + ."\n" + .'- attaching 挂载中'."\n" + ."\n" + .'- detaching 卸载中'."\n" + ."\n" + .'- deleting 删除中'."\n" + ."\n" + .'- deleted 已删除'."\n" + ."\n" + .'- resizing 扩容中'."\n" + ."\n" + .'- snapshotting 快照中'."\n" + ."\n" + .'- upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'SizeG' => ['title' => '容量（GB）', 'description' => '容量（GB）。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'RegionId' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'SnapshotCount' => ['description' => '快照总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'TotalSize' => ['description' => '快照链中所有快照的大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '50331648'], ], ], ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -4975,37 +2427,41 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'ParameterEmpty.PolicyId', 'errorMessage' => 'The value of policyId is empty.', 'description' => '策略ID值未填写。'], ], [ - [ - 'errorCode' => 'PermissionDeny.Policy', - 'errorMessage' => 'The account has no permission on this policy.', - ], + ['errorCode' => 'PermissionDeny.Policy', 'errorMessage' => 'The account has no permission on this policy.', 'description' => ''], ], 404 => [ - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', + ['errorCode' => 'InvalidRegionId.NotFound', 'errorMessage' => 'The specified RegionId does not exist.', 'description' => '指定的地域 ID 不存在。'], + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsList\\": [\\n {\\n \\"FsId\\": \\"dbfs-ejdvesb0qvuywvg*******\\",\\n \\"FsName\\": \\"test\\",\\n \\"Status\\": \\"attached\\",\\n \\"SizeG\\": 20,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '列出该自动快照策略已设置的文件系统', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-01-06T06:21:06.000Z', 'description' => '响应参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-01-03T02:42:12.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicyAppliedDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Data\\": {\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\",\\n \\"PolicyName\\": \\"PolicyTest\\",\\n \\"AccountId\\": \\"13523459********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Status\\": \\"Normal\\",\\n \\"StatusDetail\\": \\"-\\",\\n \\"RetentionDays\\": 30,\\n \\"AppliedDbfsNumber\\": 1,\\n \\"RepeatWeekdays\\": [\\n \\"\\\\\\"1\\\\\\"\\"\\n ],\\n \\"TimePoints\\": [\\n \\"\\\\\\"01\\\\\\"\\"\\n ],\\n \\"CreatedTime\\": \\"1670998784000\\",\\n \\"LastModified\\": \\"1670998784000\\"\\n },\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '查询单个自动快照策略', ], - 'ListAutoSnapshotPolicies' => [ - 'summary' => '查询您在某个地域下，所有已创建的符合查询条件的自动快照策略。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListAutoSnapshotPolicyUnappliedDbfs' => [ + 'summary' => '查询您在某个地域下，所有已创建的符合查询条件的未设置自动快照策略的数据库文件系统。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5017,51 +2473,24 @@ 'operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREdbfsOC34E7', - ], + 'abilityTreeNodes' => ['FEATUREdbfsOC34E7'], 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => false, - 'maximum' => '999999', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '999999', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], + 'schema' => ['description' => '分页查询时设置的每页条数。默认值10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '10', 'example' => '10', 'default' => '10'], ], [ 'name' => 'FilterKey', @@ -5069,198 +2498,86 @@ 'schema' => [ 'description' => '查询资源时的筛选键。'."\n" ."\n" - .'与FilterValue配合使用，取值必须为PolicyId或PolicyName。'."\n" + .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" ."\n" - .'传入PolicyId则根据自动快照策略ID进行筛选，传入PolicyName则根据自动快照策略名称进行筛选。', + .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', 'type' => 'string', 'required' => false, - 'example' => 'PolicyName', - 'enum' => [ - 'PolicyId', - 'PolicyName', - ], + 'example' => 'FsName', + 'enum' => ['FsId', 'FsName'], ], ], [ 'name' => 'FilterValue', 'in' => 'query', - 'schema' => [ - 'description' => '查询自动快照策略时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'policyTest', - ], + 'schema' => ['description' => '查询资源时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'DBFS1'], ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ - 'title' => 'PlainResponse<PageResponse<AutoSnapshotPolicyViewModel>>', + 'title' => 'PlainResponse<PageResponse<DbfsOnAutoSnapshotPolicyViewModel>>', 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '分页查询时设置的每页条数。默认值：10。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '自动快照策略的总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'SnapshotPolicies' => [ - 'description' => '自动快照策略详情列表。', + 'PageNumber' => ['description' => '分页查询时设置的页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '分页查询时设置的每页条数。默认值10。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'DbfsList' => [ + 'description' => '未设置自动快照策略的DBFS列表。', 'type' => 'array', 'items' => [ - 'description' => '自动快照策略信息详情。', + 'description' => '未设置自动快照策略的DBFS。', 'type' => 'object', 'properties' => [ - 'PolicyId' => [ - 'title' => '策略ID', - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'example' => 'sp-z5siir3iq3m**********'."\n", - ], - 'PolicyName' => [ - 'title' => '自动快照策略名称', - 'description' => '自动快照策略名称。', - 'type' => 'string', - 'example' => 'policyTest', - ], - 'AccountId' => [ - 'title' => '账户ID', - 'description' => '账户ID。', - 'type' => 'string', - 'example' => '13523459********', - ], - 'RegionId' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'Status' => [ - 'title' => '策略状态', - 'description' => '策略状态。', - 'type' => 'string', - 'enumValueTitles' => [ - 'normal' => 'normal', - 'abnormal' => 'abnormal', - ], - 'example' => 'normal', - ], - 'StatusDetail' => [ - 'description' => '若出现异常的状态信息详情，status为normal时为空。', - 'type' => 'string', - 'example' => '-', - ], - 'RetentionDays' => [ - 'title' => '快照保留天数（1-65535，NULL为永久保存）', - 'description' => '快照保留天数（1-65535，NULL为持续保存，直至快照数量达到额度上限后被自动删除）。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'AppliedDbfsNumber' => [ - 'title' => '设置的dbfs数', - 'description' => '设置该自动快照策略的数据库文件系统数量。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RepeatWeekdays' => [ - 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" - ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" - ."\n" - .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的重复日期，周期为星期。', - 'type' => 'string', - 'example' => '"1"', - ], - ], - 'TimePoints' => [ - 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" - ."\n" - .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" - ."\n" - .'- 当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', - 'type' => 'array', - 'items' => [ - 'description' => '自动快照的创建时间点。', - 'type' => 'string', - 'example' => ' "01"', - ], - ], - 'CreatedTime' => [ - 'description' => '创建时间。', - 'type' => 'string', - 'example' => '1670998784000', - ], - 'LastModified' => [ - 'description' => '最后修改时间。', - 'type' => 'string', - 'example' => '1670998784000', - ], + 'FsId' => ['title' => 'DBFS实例ID', 'description' => 'DBFS实例ID。', 'type' => 'string', 'example' => 'dbfs-ejdvesb0qvuywvg*******'], + 'FsName' => ['title' => 'DBFS实例名称', 'description' => 'DBFS实例名称。', 'type' => 'string', 'example' => 'test'], + 'Status' => ['description' => '数据库文件系统的状态。'."\n" + ."\n" + .'取值范围：'."\n" + ."\n" + .'- unattached 待挂载'."\n" + ."\n" + .'- attached 已挂载'."\n" + ."\n" + .'- creating 创建中'."\n" + ."\n" + .'- attaching 挂载中'."\n" + ."\n" + .'- detaching 卸载中'."\n" + ."\n" + .'- deleting 删除中'."\n" + ."\n" + .'- deleted 已删除'."\n" + ."\n" + .'- resizing 扩容中'."\n" + ."\n" + .'- snapshotting 快照中'."\n" + ."\n" + .'- upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'SizeG' => ['title' => '容量（GB）', 'description' => '容量（GB）。', 'type' => 'integer', 'format' => 'int64', 'example' => '20'], + 'RegionId' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'SnapshotCount' => ['description' => '快照总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'TotalSize' => ['description' => '快照链中所有快照的大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '50331648'], ], ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -5268,26 +2585,34 @@ ], 'errorCodes' => [ 404 => [ - [ - 'errorCode' => 'InvalidRegionId.NotFound', - 'errorMessage' => 'The specified RegionId does not exist.', + ['errorCode' => 'InvalidRegionId.NotFound', 'errorMessage' => 'The specified RegionId does not exist.', 'description' => '指定的地域 ID 不存在。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsList\\": [\\n {\\n \\"FsId\\": \\"dbfs-ejdvesb0qvuywvg*******\\",\\n \\"FsName\\": \\"test\\",\\n \\"Status\\": \\"attached\\",\\n \\"SizeG\\": 20,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '列出未设置自动快照策略的文件系统', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-01-06T06:21:06.000Z', 'description' => '响应参数发生变更、响应参数发生变更'], + ['createdAt' => '2023-01-03T02:42:12.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicyUnappliedDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'staticInfo' => [], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"SnapshotPolicies\\": [\\n {\\n \\"PolicyId\\": \\"sp-z5siir3iq3m**********\\\\n\\",\\n \\"PolicyName\\": \\"policyTest\\",\\n \\"AccountId\\": \\"13523459********\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Status\\": \\"normal\\",\\n \\"StatusDetail\\": \\"-\\",\\n \\"RetentionDays\\": 30,\\n \\"AppliedDbfsNumber\\": 1,\\n \\"RepeatWeekdays\\": [\\n \\"\\\\\\"1\\\\\\"\\"\\n ],\\n \\"TimePoints\\": [\\n \\" \\\\\\"01\\\\\\"\\"\\n ],\\n \\"CreatedTime\\": \\"1670998784000\\",\\n \\"LastModified\\": \\"1670998784000\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '列出自动快照策略', ], - 'ListAutoSnapshotPolicyUnappliedDbfs' => [ - 'summary' => '查询您在某个地域下，所有已创建的符合查询条件的未设置自动快照策略的数据库文件系统。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListDbfs' => [ + 'summary' => '调用ListDbfs查询您已经创建的数据库文件系统列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5296,255 +2621,262 @@ 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'list', + 'operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREdbfsOC34E7', - ], + 'abilityTreeNodes' => ['FEATUREdbfsUCP4CQ'], 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => false, - 'maximum' => '999999', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '当前页码。'."\n" + ."\n" + .'默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => true, 'maximum' => '999999', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。默认值10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], + 'schema' => ['description' => '分页查询时设置的每页条数。'."\n" + ."\n" + .'最大值：100。'."\n" + ."\n" + .'默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '10', 'example' => '10', 'default' => '10'], + ], + [ + 'name' => 'SortKey', + 'in' => 'query', + 'schema' => ['description' => '查询资源时设置排序方式。'."\n" + ."\n" + .'与SortType配合使用，取值必须为SizeG或CreatedTime。'."\n" + ."\n" + .'取值为SizeG则根据容量排序，取值为CreatedTime则根据创建时间排序。'."\n" + ."\n" + .'默认根据创建时间倒序排列。', 'type' => 'string', 'required' => false, 'example' => 'SizeG'], + ], + [ + 'name' => 'SortType', + 'in' => 'query', + 'schema' => ['description' => '查询资源时设置排序方式。'."\n" + ."\n" + .'与SortKey配合使用，取值必须为asc或desc。'."\n" + ."\n" + .'取值为asc则正序排列，取值为desc则正序排列。'."\n" + ."\n" + .'默认根据创建时间倒序排列。', 'type' => 'string', 'required' => false, 'example' => 'desc'], ], [ 'name' => 'FilterKey', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" - ."\n" - .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'FsName', - 'enum' => [ - 'FsId', - 'FsName', - ], - ], + 'schema' => ['description' => '查询资源时的筛选键。'."\n" + ."\n" + .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" + ."\n" + .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'FsName'], ], [ 'name' => 'FilterValue', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'DBFS1', - ], + 'schema' => ['description' => '查询资源时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'dbfs-test-01'], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'schema' => ['description' => '根据标签筛选数据库文件系统列表。'."\n" + ."\n" + .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" + ."\n" + .' TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', 'type' => 'string', 'required' => false, 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]'], ], ], 'responses' => [ 200 => [ 'headers' => [], 'schema' => [ - 'title' => 'PlainResponse<PageResponse<DbfsOnAutoSnapshotPolicyViewModel>>', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '分页查询时设置的每页条数。默认值10。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'DbfsList' => [ - 'description' => '未设置自动快照策略的DBFS列表。', + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '32'], + 'PageSize' => ['description' => '输入时设置的每页条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'PageNumber' => ['description' => '当前页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'DBFSInfo' => [ + 'description' => '数据库文件系统集合。', 'type' => 'array', 'items' => [ - 'description' => '未设置自动快照策略的DBFS。', 'type' => 'object', 'properties' => [ - 'FsId' => [ - 'title' => 'DBFS实例ID', - 'description' => 'DBFS实例ID。', - 'type' => 'string', - 'example' => 'dbfs-ejdvesb0qvuywvg*******', - ], - 'FsName' => [ - 'title' => 'DBFS实例名称', - 'description' => 'DBFS实例名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'- unattached 待挂载'."\n" - ."\n" - .'- attached 已挂载'."\n" - ."\n" - .'- creating 创建中'."\n" - ."\n" - .'- attaching 挂载中'."\n" - ."\n" - .'- detaching 卸载中'."\n" - ."\n" - .'- deleting 删除中'."\n" - ."\n" - .'- deleted 已删除'."\n" - ."\n" - .'- resizing 扩容中'."\n" - ."\n" - .'- snapshotting 快照中'."\n" - ."\n" - .'- upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'SizeG' => [ - 'title' => '容量（GB）', - 'description' => '容量（GB）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', + 'Status' => ['description' => '数据库文件系统的状态。'."\n" + ."\n" + .'取值范围：'."\n" + ."\n" + .'- unattached 待挂载'."\n" + ."\n" + .'- attached 已挂载'."\n" + ."\n" + .'- creating 创建中'."\n" + ."\n" + .'- attaching 挂载中'."\n" + ."\n" + .'- detaching 卸载中'."\n" + ."\n" + .'- deleting 删除中'."\n" + ."\n" + .'- deleted 已删除'."\n" + ."\n" + .'- resizing 扩容中'."\n" + ."\n" + .'- snapshotting 快照中'."\n" + ."\n" + .'- upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'Encryption' => ['description' => '是否为加密的数据库文件系统。', 'type' => 'boolean', 'example' => 'false'], + 'PayType' => ['description' => '数据库文件系统的付费类型，目前仅支持按量付费（postpaid）。', 'type' => 'string', 'example' => 'postpaid'], + 'FsId' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + 'Tags' => [ + 'description' => '标签集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'TagValue' => ['description' => '标签值。', 'type' => 'string', 'example' => 'TestTagValue1'], + 'Id' => ['description' => '标签ID。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'TagKey' => ['description' => '标签键。', 'type' => 'string', 'example' => 'TestTagKey1'], + ], + 'description' => '', + ], ], - 'RegionId' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'example' => 'cn-hangzhou', + 'SizeG' => ['description' => '数据库文件系统大小，单位GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'EcsList' => [ + 'description' => '挂载到的ECS实例集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'EcsId' => ['description' => '已挂载的ECS实例ID。', 'type' => 'string', 'example' => 'i-y2vZ3********vvMilZ2hQ'], + ], + 'description' => '', + ], ], - 'SnapshotCount' => [ - 'description' => '快照总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', + 'EbsList' => [ + 'description' => '云盘列表。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'EbsId' => ['description' => 'DBFS使用的云盘ID。', 'type' => 'string', 'example' => 'd-bp1383******3uir001r'], + 'SizeG' => ['description' => '云盘容量。单位GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + ], + 'description' => '', + ], ], - 'TotalSize' => [ - 'description' => '快照链中所有快照的大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50331648', + 'RegionId' => ['description' => '数据库文件系统所属的地域ID。', 'type' => 'string', 'example' => 'cn-hangzhou'], + 'DBFSClusterId' => ['description' => '数据库文件系统集群ID。', 'type' => 'string', 'example' => 'c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD'], + 'ZoneId' => ['description' => '数据库文件系统所属的可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-i'], + 'FsName' => ['description' => '数据库文件系统名称。', 'type' => 'string', 'example' => 'dbfs-test-01'], + 'Category' => ['description' => '数据库文件系统类型。取值范围：'."\n" + ."\n" + .'- standard：标准版'."\n" + ."\n" + .'- enterprise：企业版（公测中）', 'type' => 'string', 'example' => 'standard'], + 'CreatedTime' => ['description' => '创建时间。', 'type' => 'string', 'example' => '1609330367000'], + 'AttachNodeNumber' => ['description' => '数据库文件系统挂载的节点数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'KMSKeyId' => ['description' => '数据库文件系统使用的KMS密钥ID。', 'type' => 'string', 'example' => '0e478b7a-4262-4802-b8cb-00d3fb408***'], + 'PerformanceLevel' => ['description' => '云盘性能等级。取值范围：'."\n" + ."\n" + .'- PL0'."\n" + ."\n" + .'- PL1'."\n" + ."\n" + .'- PL2'."\n" + ."\n" + .'- PL3', 'type' => 'string', 'example' => 'PL1'], + 'UsedScene' => ['description' => '使用场景。', 'type' => 'string', 'example' => 'MySQL 5.7'], + 'LastMountTime' => ['description' => '最后挂载时间。', 'type' => 'string', 'example' => '1644915400000'], + 'LastUmountTime' => ['description' => '最后卸载时间。', 'type' => 'string', 'example' => '1644915319000'], + 'EnableRaid' => ['description' => '是否使能RAID。', 'type' => 'boolean', 'example' => 'false'], + 'RaidStrip' => ['description' => '条带数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'InstanceType' => ['description' => 'DBFS实例规格。取值范围：'."\n" + ."\n" + .'- dbfs.small'."\n" + ."\n" + .'- dbfs.medium'."\n" + ."\n" + .'- dbfs.large', 'type' => 'string', 'example' => 'dbfs.small'], + 'LastFailed' => ['description' => '最近一次操作失败的原因。', 'type' => 'string', 'example' => 'TargetIsBusy.DBFS'], + 'SnapshotInfo' => [ + 'description' => '相关快照信息。', + 'type' => 'object', + 'properties' => [ + 'SnapshotCount' => ['description' => '快照总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'TotalSize' => ['description' => '快照链中所有快照的大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '50331648'], + 'LinkId' => ['description' => '快照链id，若没有快照链则为“-”。', 'type' => 'string', 'example' => 'sl-b3zlgraysgcs9jy*******'], + 'PolicyId' => ['description' => '自动快照策略id，若没有设置自动快照策略则为“-”。', 'type' => 'string', 'example' => 'sp-ehuhzlfetb2jiwz*******'], + ], ], ], + 'description' => '', ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 404 => [ - [ - 'errorCode' => 'InvalidRegionId.NotFound', - 'errorMessage' => 'The specified RegionId does not exist.', + 400 => [ + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 32,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"DBFSInfo\\": [\\n {\\n \\"Status\\": \\"attached\\",\\n \\"Encryption\\": false,\\n \\"PayType\\": \\"postpaid\\",\\n \\"FsId\\": \\"dbfs-GOrr********Yd0VLOyBpg\\",\\n \\"Tags\\": [\\n {\\n \\"TagValue\\": \\"TestTagValue1\\",\\n \\"Id\\": 1,\\n \\"TagKey\\": \\"TestTagKey1\\"\\n }\\n ],\\n \\"SizeG\\": 20,\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-y2vZ3********vvMilZ2hQ\\"\\n }\\n ],\\n \\"EbsList\\": [\\n {\\n \\"EbsId\\": \\"d-bp1383******3uir001r\\",\\n \\"SizeG\\": 20\\n }\\n ],\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"DBFSClusterId\\": \\"c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"FsName\\": \\"dbfs-test-01\\",\\n \\"Category\\": \\"standard\\",\\n \\"CreatedTime\\": \\"1609330367000\\",\\n \\"AttachNodeNumber\\": 1,\\n \\"KMSKeyId\\": \\"0e478b7a-4262-4802-b8cb-00d3fb408***\\",\\n \\"PerformanceLevel\\": \\"PL1\\",\\n \\"UsedScene\\": \\"MySQL 5.7\\",\\n \\"LastMountTime\\": \\"1644915400000\\",\\n \\"LastUmountTime\\": \\"1644915319000\\",\\n \\"EnableRaid\\": false,\\n \\"RaidStrip\\": 2,\\n \\"InstanceType\\": \\"dbfs.small\\",\\n \\"LastFailed\\": \\"TargetIsBusy.DBFS\\",\\n \\"SnapshotInfo\\": {\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648,\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\",\\n \\"PolicyId\\": \\"sp-ehuhzlfetb2jiwz*******\\"\\n }\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TotalCount>32</TotalCount>\\n<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<PageSize>10</PageSize>\\n<PageNumber>1</PageNumber>\\n<DBFSInfo>\\n <Status>attached</Status>\\n <LastFailed>TargetIsBusy.DBFS</LastFailed>\\n <KMSKeyId>0e478b7a-4262-4802-b8cb-00d3fb408***</KMSKeyId>\\n <CreatedTime>1609330367000</CreatedTime>\\n <Category>standard</Category>\\n <EnableRaid>false</EnableRaid>\\n <ZoneId>cn-hangzhou-i</ZoneId>\\n <SizeG>20</SizeG>\\n <PerformanceLevel>PL1</PerformanceLevel>\\n <DBFSClusterId>c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD</DBFSClusterId>\\n <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>\\n <LastUmountTime>1644915319000</LastUmountTime>\\n <PayType>postpaid</PayType>\\n <Encryption>false</Encryption>\\n <FsName>dbfs-test-01</FsName>\\n <UsedScene>MySQL 5.7</UsedScene>\\n <RaidStrip>2</RaidStrip>\\n <LastMountTime>1644915400000</LastMountTime>\\n <AttachNodeNumber>1</AttachNodeNumber>\\n <RegionId>cn-hangzhou</RegionId>\\n <InstanceType>dbfs.small</InstanceType>\\n <EcsList>\\n <EcsId>i-y2vZ3********vvMilZ2hQ</EcsId>\\n </EcsList>\\n <EbsList>\\n <SizeG>20</SizeG>\\n <EbsId>d-bp1383******3uir001r</EbsId>\\n </EbsList>\\n <Tags>\\n <TagKey>TestTagKey1</TagKey>\\n <Id>1</Id>\\n <TagValue>TestTagValue1</TagValue>\\n </Tags>\\n</DBFSInfo>","errorExample":""}]', + 'title' => '查询数据库文件系统列表', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-02-27T09:18:22.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2023-01-03T02:42:12.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-01-19T07:16:37.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-10-27T06:07:17.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-05-19T11:19:18.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsList\\": [\\n {\\n \\"FsId\\": \\"dbfs-ejdvesb0qvuywvg*******\\",\\n \\"FsName\\": \\"test\\",\\n \\"Status\\": \\"attached\\",\\n \\"SizeG\\": 20,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '列出未设置自动快照策略的文件系统', ], - 'ListAutoSnapshotPolicyAppliedDbfs' => [ - 'summary' => '查询所有已设置该自动快照策略的数据库文件系统列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListDbfsAttachableEcsInstances' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -5552,327 +2884,138 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], - ], - [ - 'name' => 'PolicyId', - 'in' => 'query', - 'schema' => [ - 'description' => '自动快照策略ID。', - 'type' => 'string', - 'required' => true, - 'example' => 'sp-z5siir3iq3m**********', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'docRequired' => false, - 'maximum' => '999999', - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], + 'schema' => ['description' => '当前页码。默认值：1。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1', 'default' => '1'], ], [ 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '分页查询时设置的每页条数。默认值10。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '200', - 'minimum' => '10', - 'example' => '10', - 'default' => '10', - ], + 'schema' => ['description' => '分页查询时设置的每页行数。默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10', 'default' => '100'], ], [ 'name' => 'FilterKey', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选键。'."\n" - ."\n" - .'与FilterValue配合使用，取值必须为FsId或FsName。'."\n" - ."\n" - .'传入FsId则根据数据库文件系统的实例ID进行筛选，传入FsName则根据数据库文件系统的实例名称进行筛选。', - 'type' => 'string', - 'required' => false, - 'example' => 'FsName', - 'enum' => [ - 'FsId', - 'FsName', - ], - ], + 'schema' => ['description' => '查询资源时的筛选键。'."\n" + ."\n" + .'与FilterValue配合使用，取值必须为InstanceId或InstanceName。'."\n" + ."\n" + .'传入InstanceId则根据ECS实例ID进行筛选，传入InstanceName则根据ECS实例名称进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'InstanceName'], ], [ 'name' => 'FilterValue', 'in' => 'query', - 'schema' => [ - 'description' => '查询资源时的筛选值。'."\n" - ."\n" - .'与FilterKey配合使用。', - 'type' => 'string', - 'required' => false, - 'example' => 'DBFS1', - ], + 'schema' => ['description' => '查询资源时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'autotest1'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'title' => 'PlainResponse<PageResponse<DbfsOnAutoSnapshotPolicyViewModel>>', - 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'PageNumber' => [ - 'description' => '分页查询时设置的页码。默认值：1。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'PageSize' => [ - 'description' => '分页查询时设置的每页条数。默认值10。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], - 'TotalCount' => [ - 'description' => '查询结果总条数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'DbfsList' => [ - 'description' => '已设置该自动快照策略的DBFS列表。', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '3724CFEF-02DA-578B-AED6-67EE80671B4A'], + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '32'], + 'EcsLabelInfo' => [ + 'description' => 'ECS实例集合。', 'type' => 'array', 'items' => [ - 'description' => '已设置该自动快照策略的DBFS。', + 'description' => 'ECS实例信息。', 'type' => 'object', 'properties' => [ - 'FsId' => [ - 'title' => 'DBFS实例ID', - 'description' => 'DBFS实例ID。', - 'type' => 'string', - 'example' => 'dbfs-ejdvesb0qvuywvg*******', - ], - 'FsName' => [ - 'title' => 'DBFS实例名称', - 'description' => 'DBFS实例名称。', - 'type' => 'string', - 'example' => 'test', - ], - 'Status' => [ - 'description' => '数据库文件系统的状态。'."\n" - ."\n" - .'取值范围：'."\n" - ."\n" - .'- unattached 待挂载'."\n" - ."\n" - .'- attached 已挂载'."\n" - ."\n" - .'- creating 创建中'."\n" - ."\n" - .'- attaching 挂载中'."\n" - ."\n" - .'- detaching 卸载中'."\n" - ."\n" - .'- deleting 删除中'."\n" - ."\n" - .'- deleted 已删除'."\n" - ."\n" - .'- resizing 扩容中'."\n" - ."\n" - .'- snapshotting 快照中'."\n" - ."\n" - .'- upgrading 升级中', - 'type' => 'string', - 'example' => 'attached', - ], - 'SizeG' => [ - 'title' => '容量（GB）', - 'description' => '容量（GB）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20', - ], - 'RegionId' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], - 'SnapshotCount' => [ - 'description' => '快照总个数。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '1', - ], - 'TotalSize' => [ - 'description' => '快照链中所有快照的大小，单位为Byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50331648', - ], + 'value' => ['description' => 'ECS实例ID。', 'type' => 'string', 'example' => 'i-bp10jb8mqajkmrejgo00'], + 'label' => ['description' => 'ECS实例名称。', 'type' => 'string', 'example' => 'dbfs-test-01'], + 'InstanceTypeFamily' => ['description' => 'ECS实例规格族。', 'type' => 'string', 'example' => 'ecs.g7se'], + 'OSName' => ['description' => 'ECS实例的操作系统名称。', 'type' => 'string', 'example' => 'Alibaba Cloud Linux 2.1903 LTS 64 bit'], + 'Status' => ['description' => 'ECS实例状态：'."\n" + .'- Pending：创建中。'."\n" + .'- Running：运行中。'."\n" + .'- Starting：启动中。'."\n" + .'- Stopping：停止中。'."\n" + .'- Stopped：已停止。', 'type' => 'string', 'example' => 'Running'], + 'ZoneId' => ['description' => '可用区ID。', 'type' => 'string', 'example' => 'cn-hangzhou-i'], + 'ImageId' => ['description' => '镜像ID。', 'type' => 'string', 'example' => 'm-bp67acfmxazb4p****'], ], ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ - 400 => [ - [ - 'errorCode' => 'ParameterEmpty.PolicyId', - 'errorMessage' => 'The value of policyId is empty.', - ], - ], - [ - [ - 'errorCode' => 'PermissionDeny.Policy', - 'errorMessage' => 'The account has no permission on this policy.', - ], - ], 404 => [ - [ - 'errorCode' => 'InvalidRegionId.NotFound', - 'errorMessage' => 'The specified RegionId does not exist.', - ], - [ - 'errorCode' => 'AutoSnapshotPolicyNotFound', - 'errorMessage' => 'The automatic snapshot policy does not exist.', + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3724CFEF-02DA-578B-AED6-67EE80671B4A\\",\\n \\"TotalCount\\": 32,\\n \\"EcsLabelInfo\\": [\\n {\\n \\"value\\": \\"i-bp10jb8mqajkmrejgo00\\",\\n \\"label\\": \\"dbfs-test-01\\",\\n \\"InstanceTypeFamily\\": \\"ecs.g7se\\",\\n \\"OSName\\": \\"Alibaba Cloud Linux 2.1903 LTS 64 bit\\",\\n \\"Status\\": \\"Running\\",\\n \\"ZoneId\\": \\"cn-hangzhou-i\\",\\n \\"ImageId\\": \\"m-bp67acfmxazb4p****\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '查询可挂载的ECS实例', + 'summary' => '调用ListDbfsAttachableEcsInstances查询数据库文件系统可挂载的ECS实例列表。', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2024-01-29T12:50:04.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-08-22T08:26:50.000Z', 'description' => '请求参数发生变更'], + ['createdAt' => '2022-08-22T06:18:59.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ['createdAt' => '2021-12-29T11:42:19.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfsAttachableEcsInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsList\\": [\\n {\\n \\"FsId\\": \\"dbfs-ejdvesb0qvuywvg*******\\",\\n \\"FsName\\": \\"test\\",\\n \\"Status\\": \\"attached\\",\\n \\"SizeG\\": 20,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"SnapshotCount\\": 1,\\n \\"TotalSize\\": 50331648\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '列出该自动快照策略已设置的文件系统', ], - 'DeleteTagsBatch' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'ListDbfsAttachedEcsInstances' => [ + 'summary' => '调用ListDbfsAttachedEcsInstances查询数据库文件系统已挂载的ECS实例列表。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'abilityTreeCode' => '15805', - 'abilityTreeNodes' => [ - 'FEATUREdbfsQMJ6C8', - ], - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DbfsList', - 'in' => 'query', - 'schema' => [ - 'description' => '待删除标签的数据库文件系统实例列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '["dbfs-nUy1tb********BQ4X8Gpw","dbfs-v0WvA********tVEVcgJLg"]', - ], - ], - [ - 'name' => 'Tags', + 'name' => 'FsId', 'in' => 'query', - 'schema' => [ - 'description' => '待删除的标签列表。'."\n" - ."\n" - .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" - ."\n" - .'TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-nUy1tb********BQ4X8Gpw'], ], ], 'responses' => [ @@ -5880,373 +3023,460 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'EcsLabelInfo' => [ + 'description' => 'ECS实例集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'MountPoint' => ['description' => '数据库文件系统挂载点。', 'type' => 'string', 'example' => '/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw'], + 'value' => ['description' => 'ECS实例ID。', 'type' => 'string', 'example' => 'i-bp10jb8mqajkmrejgo00'], + 'label' => ['description' => 'ECS实例名称。', 'type' => 'string', 'example' => 'dbfs-test-01'], + 'MountedTime' => ['description' => '数据库文件系统挂载时间。用时间戳表示，单位毫秒。', 'type' => 'string', 'example' => '1606290930000'], + 'InstanceTypeFamily' => ['description' => 'ECS实例规格族。', 'type' => 'string', 'example' => 'ecs.g7se'], + 'OSName' => ['description' => 'ECS实例的操作系统名称。', 'type' => 'string', 'example' => 'Alibaba Cloud Linux 2.1903 LTS 64 bit'], + ], + 'description' => '', + ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<DeleteTagsBatchResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</DeleteTagsBatchResponse>","errorExample":""}]', - 'title' => '批量删除标签', - 'summary' => '调用DeleteTagsBatch批量删除多个数据库文件系统实例的标签。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"EcsLabelInfo\\": [\\n {\\n \\"MountPoint\\": \\"/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw\\",\\n \\"value\\": \\"i-bp10jb8mqajkmrejgo00\\",\\n \\"label\\": \\"dbfs-test-01\\",\\n \\"MountedTime\\": \\"1606290930000\\",\\n \\"InstanceTypeFamily\\": \\"ecs.g7se\\",\\n \\"OSName\\": \\"Alibaba Cloud Linux 2.1903 LTS 64 bit\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<EcsLabelInfo>\\n <MountPoint>/mnt/dbfs/dbfs-nUy1tb********BQ4X8Gpw</MountPoint>\\n <InstanceTypeFamily>ecs.g7se</InstanceTypeFamily>\\n <OSName>Alibaba Cloud Linux 2.1903 LTS 64 bit</OSName>\\n <MountedTime>1606290930000</MountedTime>\\n <label>dbfs-test-01</label>\\n <value>i-bp10jb8mqajkmrejgo00</value>\\n</EcsLabelInfo>","errorExample":""}]', + 'title' => '查询已挂载的ECS实例', 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'TagDbfs' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2021-12-29T11:01:25.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfsAttachedEcsInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ListSnapshot' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '15821', - 'abilityTreeNodes' => [ - 'FEATUREdbfsQMJ6C8', - ], - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DbfsId', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '数据库文件系统ID。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'dbfs-nUy1tb********BQ4X8Gpw', - ], + 'schema' => ['description' => '当前页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '10240', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ - 'name' => 'Tags', + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['description' => '分页查询时设置的每页条数。'."\n" + ."\n" + .'最大值：100。'."\n" + ."\n" + .'默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '10', 'example' => '10', 'default' => '10'], + ], + [ + 'name' => 'SortKey', + 'in' => 'query', + 'schema' => ['description' => '查询快照时设置排序方式。'."\n" + ."\n" + .'与SortType配合使用，取值必须为SnapshotSize或CreatedTime。'."\n" + ."\n" + .'取值为SnapshotSize则根据快照容量排序，取值为CreatedTime则根据创建时间排序。'."\n" + ."\n" + .'默认根据创建时间倒序排列。', 'type' => 'string', 'required' => false, 'example' => 'SnapshotSize'], + ], + [ + 'name' => 'SortType', 'in' => 'query', 'schema' => [ - 'description' => '待设置的标签列表。'."\n" + 'description' => '查询快照时设置排序方式。'."\n" ."\n" - .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" + .'与SortKey配合使用，取值必须为asc或desc。'."\n" + ."\n" + .'取值为asc则正序排列，取值为desc则降序排列。'."\n" ."\n" - .'TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', + .'默认根据创建时间倒序排列。', 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]', + 'required' => false, + 'enumValueTitles' => ['asc' => 'asc', 'desc' => 'desc'], + 'example' => 'desc', ], ], + [ + 'name' => 'FilterKey', + 'in' => 'query', + 'schema' => ['description' => '查询快照时的筛选键。'."\n" + ."\n" + .'与FilterValue配合使用，取值必须为SnapshotId或SnapshotName。'."\n" + ."\n" + .'传入SnapshotId则根据快照ID进行筛选，传入SnapshotName则根据快照名称进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'SnapshotId'], + ], + [ + 'name' => 'FilterValue', + 'in' => 'query', + 'schema' => ['description' => '查询快照时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 's-bp67acfmxazb4p****'], + ], + [ + 'name' => 'FsId', + 'in' => 'query', + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => false, 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + ], + [ + 'name' => 'Status', + 'in' => 'query', + 'schema' => ['description' => '快照状态。取值范围：'."\n" + ."\n" + .'- progressing：正在创建的快照。'."\n" + ."\n" + .'- accomplished：创建成功的快照。'."\n" + ."\n" + .'- failed：创建失败的快照。'."\n" + ."\n" + .'- all（默认）：所有快照状态。', 'type' => 'string', 'required' => false, 'example' => 'accomplished'], + ], + [ + 'name' => 'SnapshotName', + 'in' => 'query', + 'schema' => ['description' => '快照名称。', 'type' => 'string', 'required' => false, 'example' => 'testSnapshotName'], + ], + [ + 'name' => 'SnapshotType', + 'in' => 'query', + 'schema' => ['description' => '快照创建类型。目前仅支持手动快照。'."\n" + .' '."\n" + .'- user：手动创建快照。'."\n" + ."\n" + .'- all（默认）：所有的快照创建类型。'."\n", 'type' => 'string', 'required' => false, 'example' => 'user'], + ], + [ + 'name' => 'SnapshotIds', + 'in' => 'query', + 'schema' => ['description' => '快照标识编码。取值可以由多个快照ID组成一个JSON数组，最多支持100个ID，ID之间用半角逗号（,）隔开。', 'type' => 'string', 'required' => false, 'example' => '["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", … "s-bp67acfmxazb6p****"]'], + ], ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '32'], + 'PageSize' => ['description' => '输入时设置的每页条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'PageNumber' => ['description' => '当前页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Snapshots' => [ + 'description' => '快照集合。', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '快照状态。可能值：'."\n" + ."\n" + .'- progressing'."\n" + ."\n" + .'- accomplished'."\n" + ."\n" + .'- failed', 'type' => 'string', 'example' => 'accomplished'], + 'CreationTime' => ['description' => '快照创建时间。', 'type' => 'string', 'example' => '1609330367000'], + 'Progress' => ['description' => '快照进度。', 'type' => 'string', 'example' => '100%'], + 'SourceFsSize' => ['description' => '源数据库文件系统容量。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'RetentionDays' => ['description' => '快照保留天数。', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'RemainTime' => ['description' => '正在创建的快照剩余完成时间，单位为秒。', 'type' => 'integer', 'format' => 'int32', 'example' => '38'], + 'LastModifiedTime' => ['description' => '快照最后修改时间。', 'type' => 'string', 'example' => '1609330367000'], + 'SnapshotType' => ['description' => '快照创建类型。可能值：'."\n" + ."\n" + .'- auto：自动创建快照。'."\n" + ."\n" + .'- user：手动创建快照。'."\n" + ."\n" + .'- all（默认）：所有的快照创建类型。', 'type' => 'string', 'example' => 'user'], + 'SnapshotName' => ['description' => '快照显示名称。如果创建时指定了快照显示名称，则返回。', 'type' => 'string', 'example' => 'testSnapshotName'], + 'Description' => ['description' => '快照描述。', 'type' => 'string', 'example' => 'testDescription'], + 'SourceFsId' => ['description' => '源数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-bp67acfmxazb4p****'], + 'SnapshotId' => ['description' => '快照ID。', 'type' => 'string', 'example' => 's-bp67acfmxazb4p****'], + 'Category' => [ + 'description' => '快照类型。可能值：'."\n" + ."\n" + .'- standard：标准版。'."\n" + ."\n" + .'- enterprise：企业版。', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'standard', + ], + 'SourceFsStripeWidth' => ['description' => '源数据库文件系统条带宽度。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + ], + 'description' => '', + ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], - ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TagDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</TagDbfsResponse>","errorExample":""}]', - 'title' => '设置标签', - 'summary' => '调用TagDbfs为一个数据库文件系统设置标签。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"TotalCount\\": 32,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"Snapshots\\": [\\n {\\n \\"Status\\": \\"accomplished\\",\\n \\"CreationTime\\": \\"1609330367000\\",\\n \\"Progress\\": \\"100%\\",\\n \\"SourceFsSize\\": 20,\\n \\"RetentionDays\\": 30,\\n \\"RemainTime\\": 38,\\n \\"LastModifiedTime\\": \\"1609330367000\\",\\n \\"SnapshotType\\": \\"user\\",\\n \\"SnapshotName\\": \\"testSnapshotName\\",\\n \\"Description\\": \\"testDescription\\",\\n \\"SourceFsId\\": \\"dbfs-bp67acfmxazb4p****\\",\\n \\"SnapshotId\\": \\"s-bp67acfmxazb4p****\\",\\n \\"Category\\": \\"standard\\",\\n \\"SourceFsStripeWidth\\": 1\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TotalCount>32</TotalCount>\\n<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n<PageSize>10</PageSize>\\n<PageNumber>1</PageNumber>\\n<Snapshots>\\n <Status>accomplished</Status>\\n <Progress>100%</Progress>\\n <Category>standard</Category>\\n <Description>testDescription</Description>\\n <RetentionDays>30</RetentionDays>\\n <SourceFsSize>20</SourceFsSize>\\n <SnapshotName>testSnapshotName</SnapshotName>\\n <SourceFsId>dbfs-bp67acfmxazb4p****</SourceFsId>\\n <SnapshotId>s-bp67acfmxazb4p****</SnapshotId>\\n <SourceFsStripeWidth>1</SourceFsStripeWidth>\\n <LastModifiedTime>1609330367000</LastModifiedTime>\\n <CreationTime>1609330367000</CreationTime>\\n <SnapshotType>user</SnapshotType>\\n <RemainTime>38</RemainTime>\\n</Snapshots>","errorExample":""}]', + 'title' => '查询快照', + 'summary' => '调用ListSnapshot查询用户创建的数据库文件系统快照列表。', 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'AddTagsBatch' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-01-07T02:58:41.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/*'], + ], + ], + ], ], + ], + 'ListSnapshotLinks' => [ + 'summary' => '查询某个地域下满足条件的快照链。', + 'methods' => ['get', 'post'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'update', - 'abilityTreeCode' => '15798', - 'abilityTreeNodes' => [ - 'FEATUREdbfsQMJ6C8', - ], - 'tenantRelevance' => 'publicInformation', + 'operationType' => 'get', + 'abilityTreeCode' => '159557', + 'abilityTreeNodes' => ['FEATUREdbfs3RTJEH'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'DbfsList', + 'name' => 'PageNumber', 'in' => 'query', - 'schema' => [ - 'description' => '待添加标签的数据库文件系统实例列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '["dbfs-nUy1tb********BQ4X8Gpw","dbfs-v0WvA********tVEVcgJLg"]', - ], + 'schema' => ['description' => '当前页码。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'docRequired' => false, 'maximum' => '999999', 'minimum' => '1', 'example' => '1', 'default' => '1'], ], [ - 'name' => 'Tags', + 'name' => 'PageSize', 'in' => 'query', - 'schema' => [ - 'description' => '待添加的标签列表。'."\n" - ."\n" - .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" - ."\n" - .' TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n", - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]', - ], + 'schema' => ['description' => '分页查询时设置的每页条数。'."\n" + ."\n" + .'最大值：100。'."\n" + ."\n" + .'默认值：10。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '200', 'minimum' => '10', 'example' => '10', 'default' => '10'], ], [ - 'name' => 'ClientToken', + 'name' => 'FilterKey', 'in' => 'query', - 'schema' => [ - 'description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。'."\n", - 'type' => 'string', - 'required' => false, - 'docRequired' => false, - 'example' => '123e4567-e89b-12d3-a456-426655440000', - ], + 'schema' => ['description' => '查询快照链时的筛选键。'."\n" + ."\n" + .'与FilterValue配合使用，取值必须为LinkId或FsId。'."\n" + ."\n" + .'传入LinkId则根据快照链ID进行筛选，传入FsId则根据文件系统ID进行筛选。', 'type' => 'string', 'required' => false, 'example' => 'FsId'], + ], + [ + 'name' => 'FilterValue', + 'in' => 'query', + 'schema' => ['description' => '查询快照链时的筛选值。'."\n" + ."\n" + .'与FilterKey配合使用。', 'type' => 'string', 'required' => false, 'example' => 'dbfs-kwziq4dpsle********'], + ], + [ + 'name' => 'FsIds', + 'in' => 'query', + 'schema' => ['description' => '数据库文件系统ID。一次最多指定100个文件系统ID。FsIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。', 'type' => 'string', 'required' => false, 'example' => '["dbfs-kwziq4dpsle********","dbfs-vuaqvfcjqsg********"]'], + ], + [ + 'name' => 'LinkIds', + 'in' => 'query', + 'schema' => ['description' => '快照链ID。一次最多指定100个快照ID。LinkIds参数取值格式为JSON数组，ID之间用半角逗号（,）隔开。', 'type' => 'string', 'required' => false, 'example' => '["sl-bp1grgphbcc9brb5****","sl-bp1c4izumvq0i5bs****","sl-bp1akk7isz866dds****"]'], ], ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', + 'TotalCount' => ['description' => '查询结果总条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'PageSize' => ['description' => '分页查询时设置的每页条数。', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'PageNumber' => ['description' => '当前页码。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'SnapshotLinks' => [ + 'description' => '快照链信息组成的集合。', + 'type' => 'array', + 'items' => [ + 'description' => '快照链信息。', + 'type' => 'object', + 'properties' => [ + 'Status' => ['description' => '数据库文件系统的状态。'."\n" + ."\n" + .'取值范围：'."\n" + ."\n" + .'- unattached 待挂载'."\n" + ."\n" + .'- attached 已挂载'."\n" + ."\n" + .'- creating 创建中'."\n" + ."\n" + .'- attaching 挂载中'."\n" + ."\n" + .'- detaching 卸载中'."\n" + ."\n" + .'- deleting 删除中'."\n" + ."\n" + .'- deleted 已删除'."\n" + ."\n" + .'- resizing 扩容中'."\n" + ."\n" + .'- snapshotting 快照中'."\n" + ."\n" + .'- upgrading 升级中', 'type' => 'string', 'example' => 'attached'], + 'TotalSize' => ['description' => '快照链中所有快照的大小，单位为Byte。', 'type' => 'integer', 'format' => 'int64', 'example' => ' '."\n" + .'50331648'], + 'SourceSize' => ['description' => '数据库文件系统容量，单位为GiB。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'FsId' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'example' => 'dbfs-q7qsgyqptjk******'], + 'EcsList' => [ + 'description' => '挂载到的ECS实例集合。', + 'type' => 'array', + 'items' => [ + 'description' => '已挂载的ECS。', + 'type' => 'object', + 'properties' => [ + 'EcsId' => ['description' => '已挂载的ECS实例ID。', 'type' => 'string', 'example' => 'i-bp1f4eo2biro*******'], + ], + ], + ], + 'SnapshotCount' => ['description' => '快照总个数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'FsName' => ['description' => 'DBFS实例名称。', 'type' => 'string', 'example' => 'test'], + 'LinkId' => ['description' => '快照链ID', 'type' => 'string', 'example' => 'sl-b3zlgraysgcs9jy*******'], + ], + ], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 404 => [ - [ - 'errorCode' => 'EntityNotExist.DBFS', - 'errorMessage' => 'The DBFS instance does not exist.', + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"TotalCount\\": 10,\\n \\"PageSize\\": 10,\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"PageNumber\\": 1,\\n \\"SnapshotLinks\\": [\\n {\\n \\"Status\\": \\"attached\\",\\n \\"TotalSize\\": 50331648,\\n \\"SourceSize\\": 20,\\n \\"FsId\\": \\"dbfs-q7qsgyqptjk******\\",\\n \\"EcsList\\": [\\n {\\n \\"EcsId\\": \\"i-bp1f4eo2biro*******\\"\\n }\\n ],\\n \\"SnapshotCount\\": 1,\\n \\"FsName\\": \\"test\\",\\n \\"LinkId\\": \\"sl-b3zlgraysgcs9jy*******\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '查询快照链', + 'description' => '调用该接口时，您需要注意：'."\n" + .'- 请求参数RegionId、FsIds、LinkIds等充当过滤器功能，参数间是逻辑与关系。'."\n" + ."\n" + .'- 如果不指定任何参数，则过滤器不起作用。当FsIds和LinkIds为空数组时，相当于不进行过滤。', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2023-03-16T11:48:21.000Z', 'description' => '请求参数发生变更、响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListSnapshotLinks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<AddTagsBatchResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</AddTagsBatchResponse>","errorExample":""}]', - 'title' => '批量设置标签', - 'summary' => '调用AddTagsBatch为多个数据库文件系统实例批量添加标签，可能存在新增标签与替换标签。', - 'requestParamsDescription' => ' ', - 'responseParamsDescription' => ' ', - 'extraInfo' => ' ', ], 'ListTagKeys' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6254,20 +3484,12 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], ], 'responses' => [ @@ -6275,70 +3497,33 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'TagKeys' => [ 'description' => '标签键列表。', 'type' => 'array', - 'items' => [ - 'description' => '标签键。', - 'type' => 'string', - 'example' => '["key1", "key2"]', - ], + 'items' => ['description' => '标签键。', 'type' => 'string', 'example' => '["key1", "key2"]'], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"TagKeys\\": [\\n \\"[\\\\\\"key1\\\\\\", \\\\\\"key2\\\\\\"]\\"\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListTagKeysResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <TagKeys>key1</TagKeys>\\n <TagKeys>key2</TagKeys>\\n</ListTagKeysResponse>","errorExample":""}]', @@ -6347,16 +3532,26 @@ 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListTagKeys', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], ], 'ListTagValues' => [ - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], @@ -6364,31 +3559,17 @@ ], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ 'name' => 'TagKey', 'in' => 'query', - 'schema' => [ - 'description' => '资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'tagKey1', - ], + 'schema' => ['description' => '资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'tagKey1'], ], ], 'responses' => [ @@ -6396,70 +3577,33 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'TagValues' => [ 'description' => '标签值列表。', 'type' => 'array', - 'items' => [ - 'description' => '标签值。', - 'type' => 'string', - 'example' => '["tagValue1", "tagValue2"]', - ], + 'items' => ['description' => '标签值。', 'type' => 'string', 'example' => '["tagValue1", "tagValue2"]'], ], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], ], 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"TagValues\\": [\\n \\"[\\\\\\"tagValue1\\\\\\", \\\\\\"tagValue2\\\\\\"]\\"\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ListTagValuesResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <TagValues>tagValue1</TagValues>\\n <TagValues>tagValue2</TagValues>\\n</ListTagValuesResponse>","errorExample":""}]', @@ -6468,114 +3612,106 @@ 'requestParamsDescription' => ' ', 'responseParamsDescription' => ' ', 'extraInfo' => ' ', - ], - 'CreateServiceLinkedRole' => [ - 'summary' => '调用CreateServiceLinkedRole创建服务关联角色，用于DBFS操作其它依赖的云资源。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListTagValues', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'ModifyAutoSnapshotPolicy' => [ + 'summary' => '修改一条自动快照策略。修改自动快照策略后，之前已设置该策略的数据库文件系统随即执行修改后的自动快照策略。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'readAndWrite', + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeCode' => '15801', - 'abilityTreeNodes' => [ - 'FEATUREdbfsUCP4CQ', - ], - 'tenantRelevance' => 'publicInformation', - ], + 'systemTags' => [], 'parameters' => [ [ - 'name' => 'RegionId', + 'name' => 'PolicyId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['title' => '策略ID', 'description' => '策略ID。', 'type' => 'string', 'required' => true, 'example' => 'sp-z5siir3iq3m**********'], ], [ - 'name' => 'ClientToken', + 'name' => 'PolicyName', 'in' => 'query', + 'schema' => ['title' => '策略名称', 'description' => '策略名称。', 'type' => 'string', 'required' => false, 'example' => 'policyTest'], + ], + [ + 'name' => 'RetentionDays', + 'in' => 'query', + 'schema' => ['title' => '保留天数', 'description' => '保留天数。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '65536', 'minimum' => '-1', 'example' => '30'], + ], + [ + 'name' => 'RepeatWeekdays', + 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'description' => '保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见[如何保证幂等性](https://help.aliyun.com/document_detail/25693.html)。', - 'type' => 'string', + 'description' => '自动快照的重复日期列表，单位为天，周期为星期。取值范围：1~7，例如1表示周一。格式说明：'."\n" + ."\n" + .'- 传入的参数需要保持JSON数组格式。例如，["1"]表示每周一重复创建自动快照。'."\n" + ."\n" + .'- 当一星期内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入7个时间点。例如，["1","3","5"]表示每周一、周三、周五重复创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的重复日期。', 'type' => 'string', 'required' => false, 'example' => '"1"'], 'required' => false, - 'example' => '123e4567-e89b-12d3-a456-426655440000', + 'maxItems' => 7, ], ], [ - 'name' => 'AutoCreateServiceLinkedRole', + 'name' => 'TimePoints', 'in' => 'query', + 'style' => 'json', 'schema' => [ - 'type' => 'string', + 'description' => '自动快照的创建时间点列表。使用UTC +8时间，单位为小时。取值范围：0~23，代表00:00至23:00共24个时间点，例如01表示01:00。格式说明：'."\n" + .'传入的参数需要保持JSON数组格式。例如，["1"]表示01:00创建自动快照。'."\n" + .'当一天内需要创建多次自动快照时，可以传入多个时间点，时间点之间用半角逗号（,）隔开，最多传入24个时间点。例如，["01","03","15"]表示01:00、03:00、15:00时创建自动快照。', + 'type' => 'array', + 'items' => ['description' => '自动快照的创建时间点。', 'type' => 'string', 'required' => false, 'example' => '"01"'], 'required' => false, + 'maxItems' => 24, ], ], + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], ], 'responses' => [ 200 => [ 'schema' => [ + 'description' => '返回结果。', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], ], @@ -6583,50 +3719,169 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', + ['errorCode' => 'ParameterInvalid.RetentionDays', 'errorMessage' => 'The RetentionDays parameter is invalid.', 'description' => '保留时间参数无效。'], + ['errorCode' => 'ParameterInvalid.RepeatWeekDays', 'errorMessage' => 'The RepeatWeekdays parameter is invalid.', 'description' => '重复日期无效。'], + ['errorCode' => 'ParameterInvalid.TimePoints', 'errorMessage' => 'The TimePoints parameter is invalid.', 'description' => '重复时间无效。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'ParameterEmpty.PolicyId', 'errorMessage' => 'The value of policyId is empty.', 'description' => '策略ID值未填写。'], + ['errorCode' => 'ParameterInvalid.PolicyName', 'errorMessage' => 'The PolicyName parameter is invalid.', 'description' => '自动快照策略名称无效。'], + ], + [ + ['errorCode' => 'PermissionDeny.Policy', 'errorMessage' => 'The account has no permission on this policy.', 'description' => ''], + ], + 404 => [ + ['errorCode' => 'AutoSnapshotPolicyNotFound', 'errorMessage' => 'The automatic snapshot policy does not exist.', 'description' => '该自动快照策略不存在。'], + ], + 409 => [ + ['errorCode' => 'OperationConflict', 'errorMessage' => 'Too many requests on automatic snapshot policy, please try again later.', 'description' => '自动快照策略操作冲突，请稍后再试。'], + ], + 503 => [ + ['errorCode' => 'AutoShapshotBusy', 'errorMessage' => 'The server is busy now, please try again later.', 'description' => '服务器繁忙，请稍后再试。'], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '修改自动快照策略', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:55.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:ModifyAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<CreateServiceLinkedRoleResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</CreateServiceLinkedRoleResponse>","errorExample":""}]', - 'title' => '创建服务关联角色', - 'description' => '权限说明：允许数据库文件存储访问您ECS和私网连接的权限，使用该权限查询、创建、扩容、挂载、卸载、删除ECS云盘，查询、创建、删除云盘快照以及创建私网连接服务。', ], - 'GetServiceLinkedRole' => [ - 'methods' => [ - 'post', - 'get', + 'ModifySnapshotAttribute' => [ + 'summary' => '修改一份快照的名称、描述。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => '所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'SnapshotId', + 'in' => 'query', + 'schema' => ['description' => '快照ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 's-y2vZ3********vvMilZ2hQ'], + ], + [ + 'name' => 'SnapshotName', + 'in' => 'query', + 'schema' => ['description' => '快照的显示名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以`http://`和`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。'."\n" + ."\n" + .'为防止和自动快照的名称冲突，不能以auto开头和dbfs-auto开头。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'testSnapshotName'], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['description' => '快照的描述。长度为2~256个英文或中文字符，不能以`http://`和`https://`开头。'."\n" + ."\n" + .'默认值：空。', 'type' => 'string', 'required' => false, 'docRequired' => false, 'example' => 'testDescription'], + ], ], - 'schemes' => [ - 'http', - 'https', + 'responses' => [ + 200 => [ + 'schema' => [ + 'description' => '返回结果。', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'AccessDeniedDetail' => [ + 'type' => 'object', + 'properties' => [ + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], + ], + 'description' => '', + ], + ], + ], + ], ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'ParameterInvalid.SnapshotDescription', 'errorMessage' => 'The SnapshotDescription parameter is invalid.', 'description' => '快照描述参数无效。'], + ['errorCode' => 'ParameterInvalid.SnapshotName', 'errorMessage' => 'The SnapshotName parameter is invalid.', 'description' => '快照名称参数无效。'], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.Snapshot', 'errorMessage' => 'The snapshot does not exist.', 'description' => '快照不存在。'], + ], + ], + 'staticInfo' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '修改快照属性', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:ModifySnapshotAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}'], + ], + ], + ], + ], + ], + 'RenameDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'abilityTreeCode' => '15808', - 'abilityTreeNodes' => [ - 'FEATUREdbfs29ABXP', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '15818', + 'abilityTreeNodes' => ['FEATUREdbfs3HYCOJ'], ], 'parameters' => [ [ + 'name' => 'FsName', + 'in' => 'query', + 'schema' => ['description' => '重命名后的数据库文件系统名称。'."\n" + ."\n" + .'取值范围：长度为2~128个字符，以英文大小写字母或中文开头，可包含数字、下划线和连字符（-）。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'NewDbfsName'], + ], + [ + 'name' => 'FsId', + 'in' => 'query', + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + ], + [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => '地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-zhangjiakou'], ], ], 'responses' => [ @@ -6634,154 +3889,178 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'AccountId' => [ - 'description' => '主账号ID。', - 'type' => 'string', - 'example' => '1352345930******', - ], - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'DbfsLinkedRole' => [ - 'description' => '是否已创建服务关联角色。'."\n" - ."\n" - .'- true: 已创建'."\n" - ."\n" - .'- false: 未创建', - 'type' => 'boolean', - 'example' => 'true', - ], - 'RegionId' => [ - 'description' => '地域ID。', - 'type' => 'string', - 'example' => 'cn-hangzhou', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '6AE8A242-E12D-55AC-A75D-F707020AD0D6'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'AuthAction' => ['type' => 'string', 'description' => ''], + 'AuthPrincipalDisplayName' => ['type' => 'string', 'description' => ''], + 'AuthPrincipalOwnerId' => ['type' => 'string', 'description' => ''], + 'AuthPrincipalType' => ['type' => 'string', 'description' => ''], + 'EncodedDiagnosticMessage' => ['type' => 'string', 'description' => ''], + 'NoPermissionType' => ['type' => 'string', 'description' => ''], + 'PolicyType' => ['type' => 'string', 'description' => ''], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidName.DBFS', 'errorMessage' => 'Invalid DBFS instance name.', 'description' => '非法的DBFS实例名称。'], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], ], - 403 => [ - [ - 'errorCode' => 'PermissionDeny.DBFS', - 'errorMessage' => 'RAM permission verification failed.', + 404 => [ + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"6AE8A242-E12D-55AC-A75D-F707020AD0D6\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"PolicyType\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '重命名数据库文件系统', + 'summary' => '调用RenameDbfs重命名一个数据库文件系统。', + 'changeSet' => [ + ['createdAt' => '2024-12-05T07:44:34.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:RenameDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"AccountId\\": \\"1352345930******\\",\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"DbfsLinkedRole\\": true,\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<GetServiceLinkedRoleResponse>\\n <AccountId>1352345930******</AccountId>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n <DbfsLinkedRole>true</DbfsLinkedRole>\\n <RegionId>cn-hangzhou</RegionId>\\n</GetServiceLinkedRoleResponse>","errorExample":""}]', - 'title' => '查询服务关联角色', - 'summary' => '调用GetServiceLinkedRole查询用户是否已经创建过服务关联角色。', ], - 'DescribeDbfsSpecifications' => [ - 'summary' => '调用DescribeDbfsSpecifications查询DBFS的规格信息。', - 'methods' => [ - 'post', - 'get', + 'ResizeDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], + 'parameters' => [ + [ + 'name' => 'RegionId', + 'in' => 'query', + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'FsId', + 'in' => 'query', + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + ], + [ + 'name' => 'NewSizeG', + 'in' => 'query', + 'schema' => ['description' => '扩容后的数据库文件系统容量，必须大于扩容前的数据库文件系统容量。单位GiB。', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'docRequired' => true, 'minimum' => '20', 'example' => '40'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], + 'AccessDeniedDetail' => [ + 'type' => 'object', + 'properties' => [ + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], + ], + 'description' => '', + ], + ], + 'description' => '', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ['errorCode' => 'InvalidSize.DBFS', 'errorMessage' => 'The size of DBFS is invalid.', 'description' => '非法的容量大小。'], + ['errorCode' => 'InvalidStatus.DBFS', 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', 'description' => ''], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], ], - 'schemes' => [ - 'http', - 'https', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<ResizeDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</ResizeDbfsResponse>","errorExample":""}]', + 'title' => '扩容数据库文件系统', + 'summary' => '调用ResizeDbfs扩容一个数据库文件系统。', + 'description' => '- 扩容后的数据库文件系统容量必须大于扩容前的容量。'."\n" + ."\n" + .'- 数据库文件系统的状态必须为已挂载（attached）。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ['createdAt' => '2022-03-02T13:03:00.000Z', 'description' => '请求参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:ResizeDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], ], + ], + 'TagDbfs' => [ + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'readAndWrite', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREdbfs9JXLXY', - ], + 'operationType' => 'update', + 'abilityTreeCode' => '15821', + 'abilityTreeNodes' => ['FEATUREdbfsQMJ6C8'], 'tenantRelevance' => 'publicInformation', ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', - ], + 'schema' => ['description' => '所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], ], [ - 'name' => 'EcsInstanceType', + 'name' => 'DbfsId', 'in' => 'query', - 'schema' => [ - 'description' => 'ECS实例规格族。', - 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'ecs.g7se', - ], + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-nUy1tb********BQ4X8Gpw'], ], [ - 'name' => 'Category', + 'name' => 'Tags', 'in' => 'query', - 'schema' => [ - 'description' => 'DBFS版本类型。取值范围：'."\n" - ."\n" - .'- standard'."\n" - ."\n" - .'- enterprise', - 'type' => 'string', - 'required' => true, - 'example' => 'enterprise', - ], + 'schema' => ['description' => '待设置的标签列表。'."\n" + ."\n" + .'TagKey：资源的标签键。取值范围：最大长度为64个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?'."\n" + ."\n" + .'TagValue：资源的标签值。取值范围：最大长度为128个字符，可包含英文大小写字母、中文、数字和特殊符号@_-=+;:,<.>/?', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => '[{"TagKey":"k1","TagValue":"v1"},{"TagKey":"k2","TagValue":"v2"}]'], ], ], 'responses' => [ @@ -6789,204 +4068,138 @@ 'schema' => [ 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '187BCB3B-12E6-58B0-8E71-E19A895F49EF', - ], - 'SupportedEcsInstanceTypeFamily' => [ - 'description' => '支持的ECS实例规格族列表。', - 'type' => 'array', - 'items' => [ - 'description' => 'ECS实例规格族。', - 'type' => 'string', - 'example' => '["ecs.g7se","ecs.r7se","ecs.c7se"]', - ], - ], - 'MaxDbfsNumberPerEcs' => [ - 'description' => '单台ECS最多支持挂载的DBFS实例数。', - 'type' => 'object', - 'example' => '{"enterprise": 4}', - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], ], + 'description' => '', ], ], + 'description' => '', ], ], ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => '不支持的区域。'], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], + ], + ], + 'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"<TagDbfsResponse>\\n <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>\\n</TagDbfsResponse>","errorExample":""}]', + 'title' => '设置标签', + 'summary' => '调用TagDbfs为一个数据库文件系统设置标签。', + 'requestParamsDescription' => ' ', + 'responseParamsDescription' => ' ', + 'extraInfo' => ' ', + 'changeSet' => [ + ['createdAt' => '2024-12-31T03:35:54.000Z', 'description' => '响应参数发生变更'], + ], + 'ramActions' => [ + [ + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:TagDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"187BCB3B-12E6-58B0-8E71-E19A895F49EF\\",\\n \\"SupportedEcsInstanceTypeFamily\\": [\\n \\"[\\\\\\"ecs.g7se\\\\\\",\\\\\\"ecs.r7se\\\\\\",\\\\\\"ecs.c7se\\\\\\"]\\"\\n ],\\n \\"MaxDbfsNumberPerEcs\\": {\\n \\"enterprise\\": 4\\n },\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '查询DBFS规格信息', ], - 'DescribeInstanceTypes' => [ - 'summary' => '调用DescribeInstanceTypes查询DBFS支持的实例规格列表。', - 'methods' => [ - 'post', - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], + 'UpdateDbfs' => [ + 'summary' => '修改一个数据库文件系统的实例规格和使用场景。', + 'methods' => ['post', 'get'], + 'schemes' => ['http', 'https'], 'security' => [ [ 'AK' => [], ], ], - 'operationType' => 'read', + 'operationType' => 'write', 'deprecated' => false, 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - 'abilityTreeNodes' => [ - 'FEATUREdbfs29ABXP', - ], - 'tenantRelevance' => 'publicInformation', + 'operationType' => 'update', + 'abilityTreeCode' => '150809', + 'abilityTreeNodes' => ['FEATUREdbfsS28E99', 'FEATUREdbfsQMJ6C8'], ], 'parameters' => [ [ 'name' => 'RegionId', 'in' => 'query', + 'schema' => ['description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'cn-hangzhou'], + ], + [ + 'name' => 'FsId', + 'in' => 'query', + 'schema' => ['description' => '数据库文件系统ID。', 'type' => 'string', 'required' => true, 'docRequired' => true, 'example' => 'dbfs-GOrr********Yd0VLOyBpg'], + ], + [ + 'name' => 'UsedScene', + 'in' => 'query', + 'schema' => ['description' => '修改后的使用场景。取值范围：'."\n" + ."\n" + .'- MySQL 5.7'."\n" + ."\n" + .'- PostgreSQL'."\n" + ."\n" + .'- MongoDB'."\n" + ."\n" + .'- Oracle RAC', 'type' => 'string', 'required' => false, 'example' => 'MySQL 5.7'], + ], + [ + 'name' => 'InstanceType', + 'in' => 'query', 'schema' => [ - 'title' => '地域ID', - 'description' => 'DBFS实例所属的地域ID。您可以调用[DescribeRegions](https://help.aliyun.com/document_detail/25609.html)查看最新的阿里云地域列表。', + 'description' => '修改后的实例规格。取值范围：'."\n" + ."\n" + .'- dbfs.small'."\n" + ."\n" + .'- dbfs.medium'."\n" + ."\n" + .'- dbfs.large（默认值）'."\n", 'type' => 'string', - 'required' => true, - 'docRequired' => true, - 'example' => 'cn-hangzhou', + 'required' => false, + 'example' => 'dbfs.medium', + 'enum' => ['dbfs.small', 'dbfs.medium', 'dbfs.large'], ], ], + [ + 'name' => 'AdvancedFeatures', + 'in' => 'query', + 'schema' => ['description' => '可定制数据库文件存储实例使用的CPU核数、内存上限值等。', 'type' => 'string', 'required' => false, 'example' => '{"cpuCoreCount":0.5,"memorySize":512,"pageCacheSize":128}'], + ], ], 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结果', 'type' => 'object', 'properties' => [ - 'RequestId' => [ - 'title' => 'Id of the request', - 'description' => '请求ID。', - 'type' => 'string', - 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E', - ], - 'InstanceTypes' => [ - 'title' => 'Array of InstanceType', - 'description' => '实例规格列表。', - 'type' => 'array', - 'items' => [ - 'description' => '实例规格。', - 'type' => 'object', - 'properties' => [ - 'InstanceTypeId' => [ - 'description' => '实例规格ID。', - 'type' => 'string', - 'example' => 'dbfs.small', - ], - 'CpuCoreCount' => [ - 'description' => '最大CPU使用核数。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.25', - ], - 'MemorySize' => [ - 'description' => '最大内存占用（单位GiB）。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.5', - ], - 'InstanceTypeDescription' => [ - 'description' => '实例规格描述。', - 'type' => 'string', - 'example' => 'dbfs.small', - ], - ], - ], - ], + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E'], 'AccessDeniedDetail' => [ + 'title' => 'AccessDeniedDetail', + 'description' => 'AccessDeniedDetail', 'type' => 'object', 'properties' => [ - 'PolicyType' => [ - 'title' => 'PolicyType', - 'description' => 'PolicyType', - 'type' => 'string', - ], - 'AuthPrincipalOwnerId' => [ - 'title' => 'AuthPrincipalOwnerId', - 'description' => 'AuthPrincipalOwnerId', - 'type' => 'string', - ], - 'EncodedDiagnosticMessage' => [ - 'title' => 'EncodedDiagnosticMessage', - 'description' => 'EncodedDiagnosticMessage', - 'type' => 'string', - ], - 'AuthPrincipalType' => [ - 'title' => 'AuthPrincipalType', - 'description' => 'AuthPrincipalType', - 'type' => 'string', - ], - 'AuthPrincipalDisplayName' => [ - 'title' => 'AuthPrincipalDisplayName', - 'description' => 'AuthPrincipalDisplayName', - 'type' => 'string', - ], - 'NoPermissionType' => [ - 'title' => 'NoPermissionType', - 'description' => 'NoPermissionType', - 'type' => 'string', - ], - 'AuthAction' => [ - 'title' => 'AuthAction', - 'description' => 'AuthAction', - 'type' => 'string', - ], + 'AuthAction' => ['title' => 'AuthAction', 'description' => 'AuthAction', 'type' => 'string'], + 'AuthPrincipalDisplayName' => ['title' => 'AuthPrincipalDisplayName', 'description' => 'AuthPrincipalDisplayName', 'type' => 'string'], + 'AuthPrincipalOwnerId' => ['title' => 'AuthPrincipalOwnerId', 'description' => 'AuthPrincipalOwnerId', 'type' => 'string'], + 'AuthPrincipalType' => ['title' => 'AuthPrincipalType', 'description' => 'AuthPrincipalType', 'type' => 'string'], + 'EncodedDiagnosticMessage' => ['title' => 'EncodedDiagnosticMessage', 'description' => 'EncodedDiagnosticMessage', 'type' => 'string'], + 'NoPermissionType' => ['title' => 'NoPermissionType', 'description' => 'NoPermissionType', 'type' => 'string'], + 'PolicyType' => ['title' => 'PolicyType', 'description' => 'PolicyType', 'type' => 'string'], ], ], ], @@ -6995,52 +4208,817 @@ ], 'errorCodes' => [ 400 => [ - [ - 'errorCode' => 'InvalidRegion.DBFS', - 'errorMessage' => 'The region is not supported.', - ], + ['errorCode' => 'InvalidRegion.DBFS', 'errorMessage' => 'The region is not supported.', 'description' => ''], + ['errorCode' => 'InvalidStatus.DBFS', 'errorMessage' => 'The current state of the DBFS instance does not support this operation.', 'description' => ''], + ], + 404 => [ + ['errorCode' => 'EntityNotExist.DBFS', 'errorMessage' => 'The DBFS instance does not exist.', 'description' => ''], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"InstanceTypes\\": [\\n {\\n \\"InstanceTypeId\\": \\"dbfs.small\\",\\n \\"CpuCoreCount\\": 0.25,\\n \\"MemorySize\\": 0.5,\\n \\"InstanceTypeDescription\\": \\"dbfs.small\\"\\n }\\n ],\\n \\"AccessDeniedDetail\\": {\\n \\"PolicyType\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"AuthAction\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '查询实例规格', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\\",\\n \\"AccessDeniedDetail\\": {\\n \\"AuthAction\\": \\"\\",\\n \\"AuthPrincipalDisplayName\\": \\"\\",\\n \\"AuthPrincipalOwnerId\\": \\"\\",\\n \\"AuthPrincipalType\\": \\"\\",\\n \\"EncodedDiagnosticMessage\\": \\"\\",\\n \\"NoPermissionType\\": \\"\\",\\n \\"PolicyType\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '修改数据库文件系统', ], ], 'endpoints' => [ + ['regionId' => 'ap-southeast-1', 'regionName' => '新加坡', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.ap-southeast-1.aliyuncs.com', 'endpoint' => 'dbfs.ap-southeast-1.aliyuncs.com', 'vpc' => 'dbfs-vpc.ap-southeast-1.aliyuncs.com'], + ['regionId' => 'cn-beijing', 'regionName' => '华北2（北京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-beijing.aliyuncs.com', 'endpoint' => 'dbfs.cn-beijing.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-beijing.aliyuncs.com'], + ['regionId' => 'cn-chengdu', 'regionName' => '西南1（成都）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-chengdu.aliyuncs.com', 'endpoint' => 'dbfs.cn-chengdu.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-chengdu.aliyuncs.com'], + ['regionId' => 'cn-hangzhou', 'regionName' => '华东1（杭州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-hangzhou.aliyuncs.com', 'endpoint' => 'dbfs.cn-hangzhou.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-hangzhou.aliyuncs.com'], + ['regionId' => 'cn-hongkong', 'regionName' => '中国香港', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-hongkong.aliyuncs.com', 'endpoint' => 'dbfs.cn-hongkong.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-hongkong.aliyuncs.com'], + ['regionId' => 'cn-huhehaote', 'regionName' => '华北5（呼和浩特）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-huhehaote.aliyuncs.com', 'endpoint' => 'dbfs.cn-huhehaote.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-huhehaote.aliyuncs.com'], + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-shanghai.aliyuncs.com', 'endpoint' => 'dbfs.cn-shanghai.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-shanghai.aliyuncs.com'], + ['regionId' => 'cn-shenzhen', 'regionName' => '华南1（深圳）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-shenzhen.aliyuncs.com', 'endpoint' => 'dbfs.cn-shenzhen.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-shenzhen.aliyuncs.com'], + ['regionId' => 'cn-zhangjiakou', 'regionName' => '华北3（张家口）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'dbfs.cn-zhangjiakou.aliyuncs.com', 'endpoint' => 'dbfs.cn-zhangjiakou.aliyuncs.com', 'vpc' => 'dbfs-vpc.cn-zhangjiakou.aliyuncs.com'], + ], + 'errorCodes' => [ + ['code' => 'AutoShapshotBusy', 'message' => 'The server is busy now, please try again later.', 'http_code' => 503, 'description' => '服务器繁忙，请稍后再试。'], + ['code' => 'AutoSnapshotPolicyNotFound', 'message' => 'The automatic snapshot policy does not exist.', 'http_code' => 404, 'description' => '该自动快照策略不存在。'], + ['code' => 'DbfsAlreadyAppliedAutoSnapshotPolicy', 'message' => 'An automatic snapshot policy has been applied on the specified dbfs.', 'http_code' => 400, 'description' => '单个文件系统只支持设置一个自动快照策略。'], + ['code' => 'DbfsId.StatusNotSupported', 'message' => 'The specified DBFS status does not support the operation.', 'http_code' => 403, 'description' => '当前数据库文件系统的状态不支持此操作。'], + ['code' => 'DbfsWithAutoSnapshotPolicy.NotFound', 'message' => 'Dbfs cancel failed.The specified dbfs does not apply this auto snapshot policy or does not exist.', 'http_code' => 400, 'description' => '取消自动快照策略失败，策略不存在或文件系统未绑定该策略。'], + ['code' => 'EntityAlreadyExist.Role', 'message' => 'The service-linked role for DBFS already exists.', 'http_code' => 400, 'description' => '数据库文件存储的服务关联角色已存在。'], + ['code' => 'EntityNotExist.DBFS', 'message' => 'The DBFS instance does not exist.(EntityNotExist.DBFS)', 'http_code' => 404, 'description' => '数据库文件存储实例不存在。'], + ['code' => 'EntityNotExist.ECS', 'message' => 'The ECS instance does not exist.', 'http_code' => 404, 'description' => 'ECS实例不存在。'], + ['code' => 'EntityNotExist.Snapshot', 'message' => 'The snapshot does not exist.', 'http_code' => 404, 'description' => '快照不存在。'], + ['code' => 'ExceedMaxCount.Tag', 'message' => 'The number of labels exceeds the upper limit.', 'http_code' => 400, 'description' => '标签个数超过上限。'], + ['code' => 'Forbidden.RAM', 'message' => 'You are not authorized to operate on the specified resource.', 'http_code' => 403, 'description' => '您没有指定资源的操作权限，请先对资源进行授权操作。'], + ['code' => 'IncorrectDiskStatus.CreatingSnapshot', 'message' => 'The current database file system has a snapshot being created, please wait for the creation to complete and then try again.', 'http_code' => 400, 'description' => '当前数据库文件系统有创建中的快照，请您等待创建完成后再试。'], + ['code' => 'IncorrectInstanceStatus', 'message' => 'The current status of the resource does not support this operation.', 'http_code' => 403, 'description' => '该资源目前的状态不支持此操作。'], + ['code' => 'InternalError', 'message' => 'An error occurred while processing your request. Please try again. If the problem still exists, submit a ticket.', 'http_code' => 500, 'description' => '内部错误，请重试。如果多次尝试失败，请提交工单。'], + ['code' => 'InternalError', 'message' => 'A server internal error occurred.', 'http_code' => 500, 'description' => '服务器内部错误。'], + ['code' => 'InvalidCategory.DBFS', 'message' => 'The category is not supported.', 'http_code' => 400, 'description' => '非法的版本类型。'], + ['code' => 'InvalidDbfs.AlreadyDetached', 'message' => 'The specified DBFS has been detached.', 'http_code' => 404, 'description' => '指定的数据库文件系统已分离。'], + ['code' => 'InvalidDbfsCategory.NotSupported', 'message' => 'The specified DBFS category is not supported.', 'http_code' => 403, 'description' => '不支持指定的数据库文件系统类型。'], + ['code' => 'InvalidDbfsCategory.NotSupported', 'message' => 'The specified DBFS category does not support online resizing.', 'http_code' => 403, 'description' => '指定的数据库文件系统类型不支持在线扩容。'], + ['code' => 'InvalidDbfsId.NotFound', 'message' => 'The specified DBFS does not exist. Please check the ID.', 'http_code' => 404, 'description' => '指定的数据库文件系统不存在。请您检查数据库文件系统 ID 是否正确。'], + ['code' => 'InvalidDbfsSize.TooLarge', 'message' => 'The size of the newly specified DBFS exceeds the limit.', 'http_code' => 403, 'description' => '指定的新数据库文件系统大小超过限制。'], + ['code' => 'InvalidDbfsSize.TooSmall', 'message' => 'The size of the newly specified DBFS is smaller than the original DBFS', 'http_code' => 403, 'description' => '指定的新数据库文件系统小于原数据库文件系统。'], + ['code' => 'InvalidInstanceId.NotFound', 'message' => 'The specified InstanceId does not exist.', 'http_code' => 404, 'description' => '指定的实例不存在，请您检查实例ID是否正确。'], + ['code' => 'InvalidName.DBFS', 'message' => 'Invalid DBFS instance name.', 'http_code' => 400, 'description' => '非法的DBFS实例名称。'], + ['code' => 'InvalidPerformanceLevel.DBFS', 'message' => 'The performance level is not supported.', 'http_code' => 400, 'description' => '非法的性能等级。'], + ['code' => 'InvalidRegion.DBFS', 'message' => 'The region is not supported.', 'http_code' => 400, 'description' => '不支持的区域。'], + ['code' => 'InvalidRegionId.NotFound', 'message' => 'The specified RegionId does not exist.', 'http_code' => 404, 'description' => '指定的地域 ID 不存在。'], + ['code' => 'InvalidSize.DBFS', 'message' => 'The size of DBFS is invalid.', 'http_code' => 400, 'description' => '非法的容量大小。'], + ['code' => 'InvalidSize.ValueNotSupported', 'message' => 'The specified Size is invalid.', 'http_code' => 400, 'description' => '指定的 Size 不合法。'], + ['code' => 'InvalidStatus.DBFS', 'message' => 'The current state of the DBFS instance does not support this operation.(InvalidStatus.DBFS)', 'http_code' => 400, 'description' => '当前DBFS实例的状态不支持该操作。'], + ['code' => 'InvalidZone.DBFS', 'message' => 'The zone is not supported.', 'http_code' => 400, 'description' => '不支持的可用区。'], + ['code' => 'InvalidZoneId.NotFound', 'message' => 'The specified zone does not exist.', 'http_code' => 404, 'description' => '指定的可用区 ID 不存在。'], + ['code' => 'MissingParamter.RegionId', 'message' => 'You must specify regionId.', 'http_code' => 400, 'description' => '参数 RegionId 不得为空。'], + ['code' => 'NotRunning.ECS', 'message' => 'The ECS instance is not in the running state.', 'http_code' => 400, 'description' => 'ECS实例不存在或状态不为运行中（Running）。'], + ['code' => 'OperationConflict', 'message' => 'Too many requests on automatic snapshot policy, please try again later.', 'http_code' => 409, 'description' => '自动快照策略操作冲突，请稍后再试。'], + ['code' => 'ParameterEmpty.PolicyId', 'message' => 'The value of policyId is empty.', 'http_code' => 400, 'description' => '策略ID值未填写。'], + ['code' => 'ParameterEmpty.SnapshotId', 'message' => 'The value of snapshotId is empty.', 'http_code' => 400, 'description' => '快照ID未填写。'], + ['code' => 'ParameterEmpty.SnapshotIds', 'message' => 'The value of snapshotIds is empty.', 'http_code' => 400, 'description' => '快照ID列表未填写。'], + ['code' => 'ParameterExceed.SnapshotId', 'message' => 'The maximum number of snapshot ID has been reached.', 'http_code' => 400, 'description' => '快照ID数量超过最大值。'], + ['code' => 'ParameterExceed.SnapshotIds', 'message' => 'The maximum number of snapshot ID has been reached.', 'http_code' => 400, 'description' => '传入的快照ID数超出最大值。'], + ['code' => 'ParameterInvalid.DbfsIds', 'message' => 'The DbfsIds parameter is invalid.', 'http_code' => 400, 'description' => '文件系统列表格式不规范。'], + ['code' => 'ParameterInvalid.PolicyName', 'message' => 'The PolicyName parameter is invalid.', 'http_code' => 400, 'description' => '自动快照策略名称无效。'], + ['code' => 'ParameterInvalid.RepeatWeekDays', 'message' => 'The RepeatWeekdays parameter is invalid.', 'http_code' => 400, 'description' => '重复日期无效。'], + ['code' => 'ParameterInvalid.RetentionDays', 'message' => 'The RetentionDays parameter is invalid.', 'http_code' => 400, 'description' => '保留时间参数无效。'], + ['code' => 'ParameterInvalid.SnapshotDescription', 'message' => 'The SnapshotDescription parameter is invalid.', 'http_code' => 400, 'description' => '快照描述参数无效。'], + ['code' => 'ParameterInvalid.SnapshotId', 'message' => 'The SnapshotId parameter is invalid.', 'http_code' => 400, 'description' => '快照id格式不规范。'], + ['code' => 'ParameterInvalid.SnapshotIds', 'message' => 'The SnapshotIds parameter is invalid.', 'http_code' => 400, 'description' => '快照id列表格式不规范。'], + ['code' => 'ParameterInvalid.SnapshotName', 'message' => 'The SnapshotName parameter is invalid.', 'http_code' => 400, 'description' => '快照名称参数无效。'], + ['code' => 'ParameterInvalid.TimePoints', 'message' => 'The TimePoints parameter is invalid.', 'http_code' => 400, 'description' => '重复时间无效。'], + ['code' => 'PermissionDeny.DBFS', 'message' => 'RAM permission verification failed.', 'http_code' => 403, 'description' => '账户 RAM 权限校验失败。'], + ['code' => 'PermissionDeny.Policy', 'message' => 'The account has no permission on this policy.', 'http_code' => 403, 'description' => '该账户没有操作该策略的权限。'], + ['code' => 'PermissionDeny.Snapshot', 'message' => 'The account has no permission on this snapshot.', 'http_code' => 403, 'description' => '没有操作该快照的权限。'], + ['code' => 'PermissionDeny.SnapshotLink', 'message' => 'The account has no permission on this snapshot link.', 'http_code' => 403, 'description' => '没有操作该快照链的权限。'], + ['code' => 'QuotaExceed.AutoSnapshotPolicy', 'message' => 'The maximum number of automatic snapshot policy has been reached.', 'http_code' => 403, 'description' => '自动快照策略数超出最大值。'], + ['code' => 'QuotaExceed.Dbfs', 'message' => 'The maximum number of DBFS is exceeded.', 'http_code' => 403, 'description' => '数据库文件系统数量已达上限。'], + ['code' => 'ResourcesNotInSameZone', 'message' => 'The specified instance and DBFS are not in the same zone.', 'http_code' => 403, 'description' => '指定的实例和数据库文件系统不在同一可用区。'], + ['code' => 'SnapshotCreatedDbfs', 'message' => 'A cloned DBFS exists under the current snapshot.', 'http_code' => 500, 'description' => '当前快照下存在克隆的DBFS。'], + ['code' => 'SnapshotLinkNotFound', 'message' => 'The snapshot link does not exist.', 'http_code' => 404, 'description' => '该快照链不存在。'], + ], + 'changeSet' => [ [ - 'regionId' => 'cn-beijing', - 'endpoint' => 'dbfs.cn-beijing.aliyuncs.com', + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'AddTagsBatch'], + ['description' => '响应参数发生变更', 'api' => 'ApplyAutoSnapshotPolicy'], + ['description' => '响应参数发生变更', 'api' => 'AttachDbfs'], + ['description' => '响应参数发生变更', 'api' => 'CancelAutoSnapshotPolicy'], + ['description' => '响应参数发生变更', 'api' => 'CreateAutoSnapshotPolicy'], + ['description' => '响应参数发生变更', 'api' => 'CreateDbfs'], + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'CreateServiceLinkedRole'], + ['description' => '响应参数发生变更', 'api' => 'CreateSnapshot'], + ['description' => '响应参数发生变更', 'api' => 'DeleteAutoSnapshotPolicy'], + ['description' => '响应参数发生变更', 'api' => 'DeleteDbfs'], + ], + 'createdAt' => '2024-12-31T03:35:38.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-zhangjiakou', - 'endpoint' => 'dbfs.cn-zhangjiakou.aliyuncs.com', + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'RenameDbfs'], + ], + 'createdAt' => '2024-12-05T07:44:19.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-huhehaote', - 'endpoint' => 'dbfs.cn-huhehaote.aliyuncs.com', + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ListDbfs'], + ], + 'createdAt' => '2024-02-27T09:13:54.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-hangzhou', - 'endpoint' => 'dbfs.cn-hangzhou.aliyuncs.com', + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'ListDbfsAttachableEcsInstances'], + ], + 'createdAt' => '2024-01-29T12:50:00.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'dbfs.cn-shanghai.aliyuncs.com', + 'apis' => [ + ['description' => '错误码发生变更、响应参数发生变更、响应参数发生变更', 'api' => 'GetDbfs'], + ], + 'createdAt' => '2023-11-07T11:50:25.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-shenzhen', - 'endpoint' => 'dbfs.cn-shenzhen.aliyuncs.com', + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'UpdateDbfs'], + ], + 'createdAt' => '2023-11-06T09:56:23.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-chengdu', - 'endpoint' => 'dbfs.cn-chengdu.aliyuncs.com', + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ListSnapshotLinks'], + ], + 'createdAt' => '2023-03-16T11:31:16.000Z', + 'description' => '', ], [ - 'regionId' => 'cn-hongkong', - 'endpoint' => 'dbfs.cn-hongkong.aliyuncs.com', + 'apis' => [ + ['description' => '响应参数发生变更、响应参数发生变更', 'api' => 'ListAutoSnapshotPolicyAppliedDbfs'], + ['description' => '响应参数发生变更、响应参数发生变更', 'api' => 'ListAutoSnapshotPolicyUnappliedDbfs'], + ], + 'createdAt' => '2023-01-06T06:07:26.000Z', + 'description' => '修改SnapshotCount和TotalSize参数类型。', ], [ - 'regionId' => 'ap-southeast-1', - 'endpoint' => 'dbfs.ap-southeast-1.aliyuncs.com', + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'DeleteDbfs'], + ], + 'createdAt' => '2023-01-05T01:43:13.000Z', + 'description' => '新增force参数，支持强制释放DBFS', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更、响应参数发生变更', 'api' => 'GetDbfs'], + ], + 'createdAt' => '2023-01-04T03:06:55.000Z', + 'description' => '修改“totalSize”为大驼峰形式“TotalSize”。', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'GetDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListAutoSnapshotPolicyAppliedDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListAutoSnapshotPolicyUnappliedDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListDbfs'], + ], + 'createdAt' => '2023-01-03T02:42:00.000Z', + 'description' => '增加快照信息显示', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CancelAutoSnapshotPolicy'], + ], + 'createdAt' => '2022-12-15T06:36:40.000Z', + 'description' => '修改参数是否必填选项。', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'ListDbfsAttachableEcsInstances'], + ], + 'createdAt' => '2022-08-22T08:27:11.000Z', + 'description' => '查询可挂载的ecs列表接口新增过滤参数', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更、响应参数发生变更', 'api' => 'ListDbfsAttachableEcsInstances'], + ], + 'createdAt' => '2022-08-22T06:19:25.000Z', + 'description' => '查询可挂载的ECS列表接口新增分页参数', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'UpdateDbfs'], + ], + 'createdAt' => '2022-08-17T09:02:23.000Z', + 'description' => '新增修改DBFS接口', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDbfs'], + ], + 'createdAt' => '2022-08-15T06:47:18.000Z', + 'description' => '创建DBFS增加AdvancedFeature参数', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'ListSnapshot'], + ], + 'createdAt' => '2022-03-22T08:39:11.000Z', + 'description' => '查询快照时返回源dbfs的条带宽度', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDbfs'], + ['description' => '请求参数发生变更', 'api' => 'ResizeDbfs'], + ], + 'createdAt' => '2022-03-02T13:03:55.000Z', + 'description' => '支持RAID0', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDbfs'], + ], + 'createdAt' => '2022-02-28T09:26:32.000Z', + 'description' => '性能等级默认值PL1', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'GetDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListDbfs'], + ], + 'createdAt' => '2022-01-19T15:22:02.000Z', + 'description' => '查询DBFS接口新增返回上一次失败的原因', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'ListDbfsAttachableEcsInstances'], + ], + 'createdAt' => '2021-12-29T11:43:03.000Z', + 'description' => '查询ecs列表接口新增instanceTypeFamily字段', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'ListDbfsAttachedEcsInstances'], + ], + 'createdAt' => '2021-12-29T11:02:17.000Z', + 'description' => '查询数据库文件系统被挂载的ECS实例列表接口中新增返回OS名称和实例规格族', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'GetDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListDbfs'], + ], + 'createdAt' => '2021-10-27T06:07:49.000Z', + 'description' => '查询接口新增实例规格字段', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'DescribeInstanceTypes'], + ], + 'createdAt' => '2021-10-26T08:59:08.000Z', + 'description' => '更正返回数据的类型', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeInstanceTypes'], + ], + 'createdAt' => '2021-10-26T08:40:13.000Z', + 'description' => '新增查询DBFS实例规格接口', + ], + [ + 'apis' => [ + ['description' => '请求参数发生变更', 'api' => 'CreateDbfs'], + ], + 'createdAt' => '2021-10-22T02:31:41.000Z', + 'description' => '新增DBFS规格选择', + ], + [ + 'apis' => [ + ['description' => 'OpenAPI 下线', 'api' => 'DescribeDbfsSpecifications'], + ], + 'createdAt' => '2021-08-09T07:15:52.000Z', + 'description' => '新增查询dbfs规格接口', + ], + [ + 'apis' => [ + ['description' => '响应参数发生变更', 'api' => 'GetDbfs'], + ['description' => '响应参数发生变更', 'api' => 'ListDbfs'], + ], + 'createdAt' => '2021-05-19T11:20:05.000Z', + 'description' => '查询DBFS时新增返回云盘ID', + ], + ], + 'flowControl' => [ + 'flowControlList' => [ + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifySnapshotAttribute'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateServiceLinkedRole'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListDbfsAttachedEcsInstances'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ResizeDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CancelAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListTagValues'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteSnapshot'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DetachDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'GetSnapshotLink'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListDbfsAttachableEcsInstances'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'GetDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ModifyAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListAutoSnapshotPolicyUnappliedDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DeleteTagsBatch'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'GetServiceLinkedRole'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AttachDbfs'], + ['threshold' => '20000', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListAutoSnapshotPolicyAppliedDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ApplyAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'UpdateDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'GetAutoSnapshotPolicy'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'AddTagsBatch'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'TagDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'RenameDbfs'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListAutoSnapshotPolicies'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListTagKeys'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeDbfsSpecifications'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListSnapshot'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'CreateSnapshot'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'ListSnapshotLinks'], + ['threshold' => '600', 'countWindow' => 60, 'regionId' => '*', 'api' => 'DescribeInstanceTypes'], + ], + 'product' => ['code' => 'dbfs', 'title' => '数据库文件存储'], + ], + 'ram' => [ + 'productCode' => 'DBFS', + 'productName' => '数据库文件存储', + 'ramCodes' => ['dbfs'], + 'ramLevel' => '资源级', + 'ramConditions' => [], + 'ramActions' => [ + [ + 'apiName' => 'AttachDbfs', + 'description' => '挂载数据库文件系统', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:AttachDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetAutoSnapshotPolicy', + 'description' => '查询单个自动快照策略', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'AddTagsBatch', + 'description' => '批量设置标签', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:AddTagsBatch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListDbfsAttachableEcsInstances', + 'description' => '查询可挂载的ECS实例', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfsAttachableEcsInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetServiceLinkedRole', + 'description' => '查询服务关联角色', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetServiceLinkedRole', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListTagKeys', + 'description' => '查询标签键', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListTagKeys', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteTagsBatch', + 'description' => '批量删除标签', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteTagsBatch', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeDbfsSpecifications', + 'description' => '查询DBFS规格信息', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:DescribeDbfsSpecifications', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CreateDbfs', + 'description' => '创建数据库文件系统', + 'operationType' => 'create', + 'additionalActions' => [ + ['action' => 'dbfs:CreateServiceLinkedRole'], + ], + 'ramAction' => [ + 'action' => 'dbfs:CreateDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/*'], + ], + ], + ], + [ + 'apiName' => 'ListAutoSnapshotPolicyUnappliedDbfs', + 'description' => '列出未设置自动快照策略的文件系统', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicyUnappliedDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'UpdateDbfs', + 'description' => '修改数据库文件系统', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:UpdateDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/{#FsId}'], + ], + ], + ], + [ + 'apiName' => 'ListSnapshot', + 'description' => '查询快照', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/*'], + ], + ], + ], + [ + 'apiName' => 'CreateAutoSnapshotPolicy', + 'description' => '创建自动快照策略', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/*'], + ], + ], + ], + [ + 'apiName' => 'CreateSnapshot', + 'description' => '创建快照', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DeleteDbfs', + 'description' => '删除数据库文件系统', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListDbfsAttachedEcsInstances', + 'description' => '查询已挂载的ECS实例', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfsAttachedEcsInstances', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListDbfs', + 'description' => '查询数据库文件系统列表', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/*'], + ], + ], + ], + [ + 'apiName' => 'ListSnapshotLinks', + 'description' => '查询快照链', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListSnapshotLinks', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'DescribeInstanceTypes', + 'description' => '查询实例规格', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:DescribeInstanceTypes', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListAutoSnapshotPolicyAppliedDbfs', + 'description' => '列出该自动快照策略已设置的文件系统', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicyAppliedDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'DetachDbfs', + 'description' => '卸载数据库文件系统', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:DetachDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ApplyAutoSnapshotPolicy', + 'description' => '设置自动快照策略', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:ApplyAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteAutoSnapshotPolicy', + 'description' => '删除自动快照策略', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:DeleteAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'ResizeDbfs', + 'description' => '扩容数据库文件系统', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:ResizeDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'ListAutoSnapshotPolicies', + 'description' => '列出自动快照策略', + 'operationType' => 'list', + 'ramAction' => [ + 'action' => 'dbfs:ListAutoSnapshotPolicies', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/*'], + ], + ], + ], + [ + 'apiName' => 'CreateServiceLinkedRole', + 'description' => '创建服务关联角色', + 'operationType' => 'create', + 'ramAction' => [ + 'action' => 'dbfs:CreateServiceLinkedRole', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'RenameDbfs', + 'description' => '重命名数据库文件系统', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:RenameDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'TagDbfs', + 'description' => '设置标签', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:TagDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetSnapshotLink', + 'description' => '获取单个快照链', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetSnapshotLink', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'GetDbfs', + 'description' => '查询单个数据库文件系统', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:GetDbfs', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + [ + 'apiName' => 'CancelAutoSnapshotPolicy', + 'description' => '取消自动快照策略', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:CancelAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'ModifySnapshotAttribute', + 'description' => '修改快照属性', + 'operationType' => 'update', + 'ramAction' => [ + 'action' => 'dbfs:ModifySnapshotAttribute', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}'], + ], + ], + ], + [ + 'apiName' => 'ModifyAutoSnapshotPolicy', + 'description' => '修改自动快照策略', + 'operationType' => '', + 'ramAction' => [ + 'action' => 'dbfs:ModifyAutoSnapshotPolicy', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ], + ], + ], + [ + 'apiName' => 'DeleteSnapshot', + 'description' => '删除快照', + 'operationType' => 'delete', + 'ramAction' => [ + 'action' => 'dbfs:DeleteSnapshot', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}'], + ], + ], + ], + [ + 'apiName' => 'ListTagValues', + 'description' => '查询标签值', + 'operationType' => 'get', + 'ramAction' => [ + 'action' => 'dbfs:ListTagValues', + 'authLevel' => 'resource', + 'actionConditions' => [], + 'resources' => [ + ['validationType' => 'always', 'product' => 'DBFS', 'resourceType' => '全部资源', 'arn' => '*'], + ], + ], + ], + ], + 'resourceTypes' => [ + ['validationType' => 'always', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/*'], + ['validationType' => 'always', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/{#PolicyId}'], + ['validationType' => 'always', 'resourceType' => 'DbfsInstance', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:dbfsinstance/{#FsId}'], + ['validationType' => 'always', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/*'], + ['validationType' => 'always', 'resourceType' => 'AutoSnapShotPolicy', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:autosnapshotpolicy/*'], + ['validationType' => 'always', 'resourceType' => 'Snapshot', 'arn' => 'acs:dbfs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}'], ], ], ]; |