华为云用户手册

请求示例 通过Domain Ids Signed URL传递成员账号信息，且指定删除资源栈实例在region间串行进行 POST https://{endpoint}/v1/stack-sets/my_hello_world_stack_set/stack-instances/deletion { "stack_set_id" : "1b15e005-bdbb-4bd7-8f9a-a09b6774b4b4", "deployment_targets" : { "regions" : [ "cn-north-7" ], "domain_ids_uri" : "https://your-bucket.cn-north-7.myhuaweicloud.com/my-domain-ids.csv" }, "operation_preferences" : { "region_concurrency_type" : "SEQUENTIAL" } } 通过Domain Ids Array传递成员账号信息，且指定删除资源栈实例在region间并行进行 POST https://{endpoint}/v1/stack-sets/my_hello_world_stack_set/stack-instances/deletion { "stack_set_id" : "1b15e005-bdbb-4bd7-8f9a-a09b6774b4b4", "deployment_targets" : { "regions" : [ "cn-north-7" ], "domain_ids" : [ "0e0bc7572c0dfb74efa6c60ecd7b1dbf" ] }, "operation_preferences" : { "region_concurrency_type" : "PARALLEL" } }

响应参数 状态码：202 表6 响应Body参数 参数 参数类型 描述 stack_set_operation_id String 资源栈集操作（stack_set_operation）的唯一Id。 此ID由 资源编排 服务在生成资源栈集操作的时候生成，为UUID。 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表8 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：401 表9 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表10 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：403 表11 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表12 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：404 表13 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表14 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：429 表15 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表16 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：500 表17 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表18 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息

功能介绍 删除资源栈实例（DeleteStackInstance） 此API用于删除指定资源栈集下指定局点（region）或指定成员账号（domain_id）的资源栈实例，并返回资源栈集操作ID（stack_set_operation_id） 请谨慎操作，删除资源栈实例将会删除与该资源栈实例相关的堆栈以及堆栈所管理的一切资源。 用户可以根据资源栈集操作ID（stack_set_operation_id），通过ShowStackSetOperationMetadata API获取资源栈集操作状态

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Client-Request-Id 是 String 用户指定的，对于此请求的唯一ID，用于定位某个请求，推荐使用UUID 表3 请求Body参数 参数 是否必选 参数类型 描述 stack_set_id 否 String 资源栈集（stack_set）的唯一ID。 此ID由资源编排服务在生成资源栈集的时候生成，为UUID。 由于资源栈集名仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的资源栈集，删除，再重新创建一个同名资源栈集。 对于团队并行开发，用户可能希望确保，当前我操作的资源栈集就是我以为的那个，而不是被其他队友删除后创建的同名资源栈集。因此，使用ID就可以做到强匹配。 资源编排服务保证每次创建的资源栈集所对应的ID都不相同，更新不会影响ID。如果给予的stack_set_id和当前资源栈集的ID不一致，则返回400 deployment_targets 是 deployment_targets object 部署目标信息。 operation_preferences 否 operation_preferences object 资源栈集操作（stack_set_operation）的部署策略。该参数只在指定的单次操作中生效。 当用户不指定该参数时，默认的操作部署策略为区域（region）内资源栈实例串行部署，即每次只执行一个资源栈实例，区域（region）间随机且串行部署，执行完一个region下的全部资源栈实例后，才会选择另一个region部署，容错次数默认为0。 该参数可以在生成资源栈集操作的四个API中指定： 创建资源栈实例（CreateStackInstance），部署资源栈集（DeployStackSet），更新资源栈实例（UpdateStackInstance），删除资源栈实例（DeleteStackInstance） call_identity 否 String 仅支持资源栈集权限模式为SERVICE_MANAGED时指定该参数。用于指定用户是以组织管理账号还是成员账号中的服务委托管理员身份调用资源栈集。默认为SELF。 当资源栈集权限模式为SELF_MANAGED时，默认为SELF。 无论指定何种用户身份，涉及操作的资源栈集始终在组织管理账号名下。* SELF - 以组织管理账号身份调用。 DELEGATED_ADMIN - 以服务委托管理员身份调用。用户的华为云账号必须在组织中已经被注册为”资源编排资源栈集服务“的委托管理员。 表4 deployment_targets 参数 是否必选 参数类型 描述 regions 是 Array of strings 用户指定资源栈集操作所涉及的区域。 在DeployStackSet API中，根据用户输入regions和domain_ids列表，以笛卡尔积的形式选择资源栈集中存在的资源栈实例进行部署。如果指定了没有被资源栈集所管理的region，则会报错。 domain_ids 否 Array of strings 当资源栈集权限模型是SELF_MANAGED时，用户指定包含本次操作涉及到的租户ID内容。 在DeployStackSet API中，如果指定该参数，根据用户输入的domain_ids列表和regions列表，以笛卡尔积的形式选择资源栈集中存在的资源栈实例进行部署。如果指定了没有被资源栈集所管理的domain_id，则会报错。 当资源栈集权限模型是SERVICE_MANAGED时，该参数需结合domain_id_filter_type使用。用于指定资源栈集操作涉及到的，从所提供的OU中指定或排除部署的租户ID信息，或除提供的OU外，还进行额外部署的租户ID信息。 domain_ids和domain_ids_uri 有且仅有一个存在。 domain_ids_uri 否 String 当资源栈集权限模型是SELF_MANAGED时，用户指定包含本次操作涉及到的租户ID内容文件的OBS地址。 内容格式要求每个租户ID以逗号（,）分隔，支持换行。当前仅支持csv文件，且文件的编码格式须为UTF-8。文件内容大小不超过100KB。 上传的csv文件应尽量避免Excel操作，以防出现读取内容不一致的问题。推荐使用记事本打开确认内容是否符合预期。 在DeployStackSet API中，如果指定该参数，根据用户输入的domain_ids_uri文件内容和regions列表，以笛卡尔积的形式选择资源栈集中存在的资源栈实例进行部署。如果内容包含了没有被资源栈集所管理的domain_id，则会报错。 当资源栈集权限模型是SERVICE_MANAGED时，该参数需结合domain_id_filter_type使用。链接文件内容用于指定资源栈集操作涉及到的，从所提供的OU中指定或排除部署的租户ID信息，或除提供的OU外，还进行额外部署的租户ID信息。 domain_ids和domain_ids_uri有且仅有一个存在。 organizational_unit_ids 否 Array of strings 组织单元（Organizational Unit，缩写OU）ID列表，仅在资源栈集权限模型是SERVICE_MANAGED时，才允许指定该参数。 用户指定的Organization组织部署的ID列表，可以是根组织（Root）ID，也可以是某些组织单元的ID。 创建资源栈实例 （CreateStackInstances）API 必须指定该参数，该API 会异步校验OU IDs 的合法性，校验有效的OU IDs 及其所有非空子OU ID 都会被资源栈集记录管理。该API允许指定没有或者已经被资源栈集管理的OU IDs。 若资源栈集不自动部署，空子OU不会被资源栈集记录管理（特指子OU下无成员账号或部署排除其下所有成员账号）。* 【暂不支持】若资源栈集开启自动部署，空子OU也会被资源栈集记录管理（特指子OU下无成员账号或部署排除其下所有成员账号），自动部署仅针对成员账号变动，不针对其他组织结构变化，例如新增OU等，新增OU不会自动被资源栈集管理。* 部署或删除资源栈实例（DeployStackSet、UpdateStackInstances、DeleteStackInstances） API，只允许指定已经被资源栈集管理的OU IDs。若指定了没有被资源栈集记录管理的OU IDs，则会报错。 删除资源栈实例 （DeleteStackInstances）API 必须指定该参数。 用户可以通过获取资源栈集元数据（ShowStackSetMetadata）API ，获取通过创建资源栈实例（CreateStackInstances）API 请求指定过的OU IDs。 资源栈集不仅会部署到目标 OU 中的用户，同时还会部署所有子 OU 下的用户。指定该参数后，资源栈集会根据用户输入的 OU 列表下所有的用户信息（包含子 OU 下的用户）和region列表，以笛卡尔积的形式，选择资源栈实例进行创建或部署。 资源栈集不会选择组织管理员作为部署目标，进行资源栈实例的创建或部署，即使组织管理员位于给与的组织或组织的 OU 中。 domain_id_filter_type 否 String 租户ID筛选类型，仅支持资源栈集权限模型是SERVICE_MANAGED时指定该参数。默认为NONE 用户可以指定不同的筛选类型，通过domain_ids或domain_ids_uri 指定或排除部署的用户信息，以增加或限制部署目标用户范围，实现不同的部署策略。 INTERSECTION - 从所提供的 OUs 中选择指定用户进行部署。指定该类型时，domain_ids和domain_ids_uri 有且仅能有一个存在。 DIFFERENCE - 从所提供的 OUs 中排除指定用户部署。指定该类型时，domain_ids和domain_ids_uri 有且仅能有一个存在。 UNION - 除了部署到提供的 OUs 外，还将部署到指定的账号中。用户可以通过同时指定organizational_unit_ids 和 domain_ids/domain_ids_uri 以实现在同一请求中部署整个OU和来自不同OU的特定个人账号。指定该类型时，domain_ids和domain_ids_uri 有且仅能有一个存在。创建资源栈实例（CreateStackInstances）除外，该API 不允许指定使用该类型。 NONE - 只部署在指定 OUs 中的所有账号。该类型下domain_ids和domain_ids_uri字段必须为空。 表5 operation_preferences 参数 是否必选 参数类型 描述 region_concurrency_type 否 String 部署资源栈实例时区域（region）的执行策略，分为两种，SEQUENTIAL和PARALLEL，区分大小写，默认值为SEQUENTIAL 详细介绍： SEQUENTIAL：顺序执行，执行完一个region下的全部资源栈实例后再去执行另一个region。默认顺序执行。 PARALLEL：并发执行，并发部署所有指定区域的资源栈实例。 region_order 否 Array of strings 区域（region）部署顺序。只有当用户指定region_concurrency_type为SEQUENTIAL时才会允许指定该参数。用户指定部署region的顺序，不允许出现资源栈集管理之外的region。 如果不指定，实际部署region顺序随机。部署顺序仅在当次部署时生效，应该包含且仅包含本次部署的所有region。 failure_tolerance_count 否 Long 容错次数。用户定义在每个区域（region）下，允许部署失败的资源栈实例数量。该参数取值默认为0，限定0和正整数。 如果定义region顺序执行（region_concurrency_type值为SEQUENTIAL），在某个region超过容错次数时，资源栈集会取消所有状态仍处于WAIT_IN_PROGRESS状态的实例。被取消的实例状态最终变为CANCEL_COMPLETE； 如果是region并行执行（region_concurrency_type值为PARALLEL），在某个region超过容错次数时，资源栈集只会取消该region下所有处于WAIT_IN_PROGRESS状态的实例。被取消的实例状态最终变为CANCEL_COMPLETE。 对处于OPERATION_IN_PROGRESS，或已经部署完成，即处于OPERATION_COMPLETE或者OPERATION_FAILED状态的资源栈实例，不受影响，状态不变。 failure_tolerance_count 和 failure_tolerance_percentage 仅能有一个存在。 failure_tolerance_percentage 否 Long 容错百分比。定义每个区域（region）下，允许部署失败的资源栈实例数占该region下所有资源栈实例数的百分比。该参数取值默认为0，限定0和正整数。 通过容错百分比*资源栈实例数，并向下取整，得到实际容错次数。 failure_tolerance_count 和 failure_tolerance_percentage 仅能有一个存在。 max_concurrent_count 否 Long 每个区域（region）下可同时部署资源栈实例的最大账号数。该参数取值默认为1，限定为正整数。 最大并发账号数最多比容错次数多1。如果用户指定failure_tolerance_percentage，最大并发账号数最多比 failure_tolerance_percentage * 资源栈实例数多1。保证部署在所需的容错级别停止。 max_concurrent_count 和 max_concurrent_percentage 仅能有一个存在。 max_concurrent_percentage 否 Long 最大并发账号百分比，每个区域（region）中可同时部署的资源栈实例的最大账号百分比。该参数取值默认为1，限定正整数。 RFS 根据百分比 *（每个region下资源栈实例数）得到的值，再向下取整，得到实际最大并发账号数。如果实际最大并发账号数向下取整值为0时，则默认选择最大并发账号数为1。 通过百分比计算得到的实际最大并发账号数最多比容错次数多1。如果用户指定failure_tolerance_percentage，实际最大并发账号数最多比 failure_tolerance_percentage * 资源栈实例数多1。保证部署在所需的容错级别停止。 max_concurrent_count 和 max_concurrent_percentage 仅能有一个存在。 failure_tolerance_mode 否 String 资源栈集操作部署的失败容忍模式，分为两种，STRICT_FAILURE_TOLERANCE和SOFT_FAILURE_TOLERANCE，区分大小写，默认值为STRICT_FAILURE_TOLERANCE。 详细介绍： STRICT_FAILURE_TOLERANCE：此选项会动态降低并发级别，以确保同region下部署失败的账号数量永远不超过 failure_tolerance_count + 1。当用户指定failure_tolerance_percentage时，确保同region下部署失败的账号数量不超过 failure_tolerance_percentage * 资源栈实例数 + 1。 初始实际最大并发数为max_concurrent_count，如果用户指定的是max_concurrent_percentage，则初始实际最大并发数为 max_concurrent_percentage * 资源栈实例数，随后，实际最大并发数会根据失败次数增加而减少。 SOFT_FAILURE_TOLERANCE：此选项将failure_tolerance_count (failure_tolerance_percentage) 与实际并发数分离开。该参数允许资源栈集操作始终以指定的 max_concurrent_count 或 max_concurrent_percentage 操作资源栈实例。 此时不保证资源栈实例失败总数小于 failure_tolerance_count + 1，如果用户指定的是failure_tolerance_percentage的值，则不保证资源栈实例失败总数小于 failure_tolerance_percentage * 资源栈实例数 + 1。

响应参数 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表5 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：401 表6 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表7 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表9 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：404 表10 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表11 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：429 表12 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表13 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：500 表14 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表15 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息

URI DELETE /v1/private-modules/{module_name}/versions/{module_version} 表1 路径参数 参数 是否必选 参数类型 描述 module_name 是 String 私有模块（private-module）的名字。此名字在domain_id+region下应唯一，可以使用中文、大小写英文、数字、下划线、中划线。首字符需为中文或者英文，区分大小写。 module_version 是 String 模块的版本号。版本号遵循语义化版本号（Semantic Version），为用户自定义 表2 Query参数 参数 是否必选 参数类型 描述 module_id 否 String 私有模块（private-module）的唯一Id。 此Id由资源编排服务在生成模块的时候生成，为UUID。 由于私有模块名称仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的私有模块，删除，再重新创建一个同名私有模块。 对于团队并行开发，用户可能希望确保，当前我操作的私有模块就是我认为的那个，而不是其他队友删除后创建的同名私有模块。因此，使用Id就可以做到强匹配。 资源编排服务保证每次创建的私有模块所对应的Id都不相同，更新不会影响Id。如果给予的module_id和当前模块的Id不一致，则返回400

请求示例 通过OBS Signed URL传递模板和参数信息 POST https://{endpoint}/v1/ba2b9930c977f71edaeaa3a5e96a8ff1/stacks/my_hello_world_stack/deployments { "template_uri" : "https://my_hello_world_bucket.{region}.myhuaweicloud.com/my-hello-world-template.tf", "vars_uri" : "https://my_hello_world_bucket.{region}.myhuaweicloud.com/my-hello-world-vars.tfvars", "stack_id" : "1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3" }

响应参数 状态码：202 表7 响应Body参数 参数 参数类型 描述 deployment_id String 部署ID 接受请求，进行异步处理。可以调用GetStackMetadata来获取异步请求的部署状态 注意： 部署资源栈后，资源编排服务持久化请求并立即返回，客户端不等待请求最终处理完成，用户无法实时感知请求处理结果 资源编排服务最终会将异步部署请求排队，在服务端空闲的情况下逐个处理。用户最大等待时长为6小时 状态码：400 表8 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表9 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：401 表10 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表11 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：403 表12 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表13 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：404 表14 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表15 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：409 表16 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表17 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：429 表18 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表19 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：500 表20 响应Body参数 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表21 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息

URI POST /v1/{project_id}/stacks/{stack_name}/deployments 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调用API处获取，也可以从控制台获取。 项目ID获取方式 stack_name 是 String 资源栈的名称。此名字在domain_id+区域+project_id下应唯一，可以使用中文、大小写英文、数字、下划线、中划线。首字符需为中文或者英文，区分大小写。

功能介绍 部署资源栈（DeployStack） 此API用于部署一个已有的资源栈 用户可以使用此API更新模板、参数等并触发一个新的部署 此API会直接触发部署，如果用户希望先确认部署会发生的时间，请使用执行计划，即使用CreateExecutionPlan以创建执行计划、使用GetExecutionPlan以获取执行计划 此API为全量API，即用户每次部署都需要给予所想要使用的template、vars的全量 部署资源栈时，用户将模板中定义的资源删除（包括Import定义的资源），会触发实际资源的删除。建议通过CreateExecutionPlan查看模板修改后资源栈的部署行为，以避免误操作非预期资源 当触发的部署失败时，如果资源栈开启了自动回滚，会触发自动回滚的流程，否则就会停留在部署失败时的状态

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Client-Request-Id 是 String 用户指定的，对于此请求的唯一ID，用于定位某个请求，推荐使用UUID 表3 请求Body参数 参数 是否必选 参数类型 描述 template_body 否 String HCL模板，描述了资源的目标状态。资源编排服务将比较此模板与当前远程资源的状态之间的区别。 template_body和template_uri 必须有且只有一个存在 在CreateStack API中，template_body和template_uri可以都不给予 注意： template_body中默认不应该含有任何敏感信息，资源编排服务会直接明文使用、log、展示、存储对应的template_body。如为敏感信息，建议将敏感信息通过vars_structure参数化，并设置encryption字段开启加密 template_uri 否 String HCL模板的OBS地址，该模板描述了资源的目标状态。资源编排服务将比较此模板与当前远程资源的状态之间的区别。 请确保OBS地址所在局点与使用RFS服务局点一致。 对应的文件应该是纯tf文件或zip压缩包 纯tf文件需要以 .tf或者 .tf.json结尾，并遵守HCL语法 压缩包目前只支持zip格式，文件需要以 .zip结尾。解压后的文件不得包含".tfvars"文件且必须是UTF8编码（其中.tf.json不能包含BOM头），zip压缩包当前支持的子文件数量最大为100 template_body和template_uri 必须有且只有一个存在 在CreateStack API中，template_body和template_uri可以都不给予 注意： template_uri对应的模板文件中默认不应该含有任何敏感信息，资源编排服务会直接明文使用、log、展示、存储对应的模板文件内容。如为敏感信息，建议将敏感信息通过vars_structure参数化，并设置encryption字段开启加密 template_uri对应的模板文件如果为zip类型，则内部的文件或文件夹名称长度不得超过255个字节，最深路径长度不得超过2048字节，zip包大小不得超过1MB vars_structure 否 Array of VarsStructure objects HCL参数结构。HCL模板支持参数传入，即，同一个模板可以给予不同的参数而达到不同的效果。 var_structure可以允许客户提交最简单的字符串类型的参数 资源编排服务支持vars_structure，vars_body和vars_uri，如果以上三种方式中声明了同一个变量，将报错400 vars_structure中的值只支持简单的字符串类型，如果需要使用其他类型，需要用户自己在HCL引用时转换， 或者用户可以使用vars_uri、vars_body，vars_uri和vars_body中支持HCL支持的各种类型以及复杂结构 如果vars_structure过大，可以使用vars_uri 注意：vars_structure中默认不应该含有任何敏感信息，资源编排服务会直接明文使用、log、展示、存储对应的vars。如为敏感信息，建议设置encryption字段开启加密 vars_body 否 String HCL参数文件的内容。HCL模板支持参数传入，即，同一个模板可以给予不同的参数而达到不同的效果。 vars_body使用HCL的tfvars格式，用户可以将“.tfvars”中的内容提交到vars_body中。 资源编排服务支持vars_structure，vars_body和vars_uri，如果以上三种方式中声明了同一个变量，将报错400 如果vars_body过大，可以使用vars_uri 如果vars中都是简单的字符串格式，可以使用var_structure 注意：vars_body中不应该含有任何敏感信息，资源编排服务会直接明文使用、log、展示、存储对应的vars。如为敏感信息，建议通过vars_structure并设置encryption字段传递 vars_uri 否 String HCL参数文件的OBS地址。HCL模板支持参数传入，即，同一个模板可以给予不同的参数而达到不同的效果。 请确保OBS地址所在局点与使用RFS服务局点一致。 资源编排服务支持vars_structure，vars_body和vars_uri，如果以上三种方式中声明了同一个变量，将报错400 vars_uri中的内容使用HCL的tfvars格式，用户可以将“.tfvars”中的内容保存到文件并上传到OBS中，并将OBS pre-signed URL传递给vars_uri。 注意：vars_uri的内容不应该含有任何敏感信息，资源编排服务会直接明文使用、log、展示、存储对应的vars。如为敏感信息，建议通过vars_structure并设置encryption字段传递 stack_id 否 String 资源栈（stack）的唯一Id。 此Id由资源编排服务在生成资源栈的时候生成，为UUID。 由于资源栈名仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的资源栈，删除，再重新创建一个同名资源栈。 对于团队并行开发，用户可能希望确保，当前我操作的资源栈就是我认为的那个，而不是其他队友删除后创建的同名资源栈。因此，使用ID就可以做到强匹配。 资源编排服务保证每次创建的资源栈所对应的ID都不相同，更新不会影响ID。如果给予的stack_id和当前资源栈的ID不一致，则返回400 表4 VarsStructure 参数 是否必选 参数类型 描述 var_key 是 String 参数的名字 var_value 是 String 参数的值。 注意，参数需要以字符串形式存在，如果是数字，也需要以字符串形式存在，如'10'。 如果需要支持不同类型，或者复杂结构，请使用vars_uri或vars_body encryption 否 EncryptionStructure object 如果用户传递的var_value是已经加密过的，可以通过声明此项以要求资源编排服务在使用前进行解密，目前暂时只支持KMS加解密 表5 EncryptionStructure 参数 是否必选 参数类型 描述 kms 是 KmsStructure object 如果用户给予的var_value是经过KMS加密的，可以通过传递相关加密信息，资源编排服务在使用的时候会帮助用户进行KMS解密 更多关于KMS加密以及KMS加密的样例代码请见： KMS加密使用场景介绍 注意： 请确保用户给予资源编排服务的委托中包含对指定密钥ID的操作权限 KMS每个月有免费试用的额度，如果超过，则KMS需要收费，此费用不是资源编排服务收取，具体标准见： https://www.huaweicloud.com/pricing.html?tab=detail#/dew KMS加密只代表资源编排服务在存储和传输的时候传递的是密文，但是在stack-events中依然是明文，如果希望在log中以密文形式对待，请在模板中声明sensitive，更多关于sensitive的介绍见： https://learn.hashicorp.com/tutorials/terraform/sensitive-variables 表6 KmsStructure 参数 是否必选 参数类型 描述 id 是 String 解密时，资源编排服务应该使用的KMS密钥的ID，通常是加密时所使用的密钥ID cipher_text 是 String 数据加密 密钥所对应的密文

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 versions Array of TemplateVersion objects 模板版本列表 表5 TemplateVersion 参数 参数类型 描述 template_id String 模板的唯一ID，由模板服务随机生成 template_name String 用户希望创建的模板名称 version_description String 模板版本的描述。可用于客户识别自己的模板版本 create_time String 版本创建时间，格式遵循RFC3339，即yyyy-mm-ddTHH:MM:SSZ，如1970-01-01T00:00:00Z version_id String 模板模板版本ID 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表7 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表9 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：403 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表11 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：404 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表13 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：429 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表15 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息 状态码：500 表16 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 encoded_authorization_message String 包含有关未经授权请求的信息。 details Array of Detail objects 权限拒绝时服务返回的详细错误信息。 表17 Detail 参数 参数类型 描述 error_code String 响应码 error_msg String 响应消息

响应示例 状态码：200 列举模板版本成功 { "versions" : [ { "template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8", "template_name" : "my_first_template", "version_description" : "当前模板的第二个版本", "create_time" : "2023-05-09T08:01:24Z", "version_id" : "V2" }, { "template_id" : "69f8d5ea-eaa4-4a3b-a96d-bae9230e97c8", "template_name" : "my_first_template", "version_description" : "当前模板的第一个版本", "create_time" : "2023-05-09T08:01:23Z", "version_id" : "V1" } ] }

请求示例 列举当前模板的所有的模板版本信息 GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions 列举当前模板的所有的模板版本信息，并提供模板id以校验是否与当前模板匹配 GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions?template_id=1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3

功能介绍 列举模板版本信息（ListTemplateVersions） 此API用于列举模板下所有的模板版本信息 默认按照生成时间降序排序，最新生成的模板排列在最前面 注意：目前返回全量模板版本信息，即不支持分页 如果没有任何模板版本，则返回空list template_id是模板的唯一Id。此Id由资源编排服务在生成模板的时候生成，为UUID。由于模板名仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的模板，删除，再重新创建一个同名模板。对于团队并行开发，用户可能希望确保，当前我操作的模板就是我认为的那个，而不是其他队友删除后创建的同名模板。因此，使用ID就可以做到强匹配。资源编排服务保证每次创建的模板所对应的ID都不相同，更新不会影响ID。如果给予的template_id和当前模板管理的ID不一致，则返回400 如果模板不存在则返回404 ListTemplateVersions返回的信息只包含模板版本摘要信息（具体摘要信息见ListTemplateVersionsResponseBody），如果用户需要了解模板版本内容，请调用ShowTemplateVersionContent

URI GET /v1/{project_id}/templates/{template_name}/versions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，可以从调用API处获取，也可以从控制台获取。 项目ID获取方式 template_name 是 String 用户希望创建的模板名称 表2 Query参数 参数 是否必选 参数类型 描述 template_id 否 String 模板的ID。当template_id存在时，模板服务会检查template_id是否和template_name匹配，不匹配会返回400

数据来源 支持上报到LTS的日志数据来源如下表1所示。 表1 数据来源 类别 场景 接入方式 应用 程序输出 CCE接入 访问日志 WAF接入 语言 Java 云日志 服务Java SDK Log4J Appender 云日志服务Log4j2 SDK LogBack Appender 云日志服务LogBack SDK Go 云日志服务Go SDK OS Linux 安装ICAgent（区域内主机） 安装ICAgent（区域外主机） Windows Docker文件 Docker输出 数据库 MySQL GaussDB for MySQL接入LTS 云数据库RDS for MySQL接入LTS SQL Server 云数据库RDS for SQLServer接入LTS PostgreSQL 云数据库RDS for PostgreSQL接入LTS 云数据库 GaussDB 数据仓库 服务GaussDB(DWS)接入LTS 云数据库 GeminiDB 云数据库GeminiDB接入LTS 云数据库GeminiDB Mongo接入LTS 云数据库GeminiDB Cassandra接入LTS 移动端 iOS、Android、百度小程序、微信小程序、钉钉小程序、支付宝小程序 使用SDK接入LTS 标准协议 HTTP轮询 使用KAFKA协议上报日志到LTS Syslog 使用KAFKA协议上报日志到LTS Kafka 使用KAFKA协议上报日志到LTS 第三方 Logstash 使用KAFKA协议上报日志到LTS Flume 使用KAFKA协议上报日志到LTS Beats 使用KAFKA协议上报日志到LTS 云日志服务云产品 E CS 、CCE等 华为云产品 日志 使用云服务接入LTS

备份策略示例 操作系统的备份策略示例 请参考SAP应用备份与恢复方案章节中对操作系统备份策略示例。 重要文件系统的备份策略示例 SAP HANA的重要文件系统如/usr/sap，/hana/shared，/etc, /home目录。 表1 重要文件系统的备份策略示例 备份对象 备份内容 备份频率 保留周期 SAP HANA开发系统 /usr/sap，/hana/shared，/etc，/home 每月备份1次 2月 SAP HANA测试系统 每月备份1次 2月 SAP HANA生产系统 每月备份2次 2月 数据库的备份策略示例 建议在实际使用中，综合使用基于文件的数据备份、日志备份和数据存储快照，最小化降低SAP HANA数据丢失的风险。 SAP官方建议SAP HANA生产系统的一般性备份策略如下： 每天进行存储快照的备份 每周进行数据备份（基于文件或基于Backint接口） 开启日志的自动备份 根据此策略，对SAP HANA备份策略示例如表2所示。 表2 SAP HANA备份策略示例 备份对象 备份内容 备份频率 保留周期 SAP HANA开发系统 完整备份或Delta备份 每周备份1次 1月 数据快照 每两天备份1次 1月 在线日志备份 每天备份1次 1月 SAP HANA测试系统 完整备份或Delta备份 每周备份1次 1月 数据快照 每半月备份1次 1月 在线日志备份 每天备份1次 1月 SAP HANA生产系统 完整备份或Delta备份 每天备份1次 1月 在线日志备份 每15分钟备份1次 1月 父主题： SAP HANA备份与恢复方案

备份方式比较 您可结合自己的实际需求，再根据SAP HANA备份方案的优劣势，选择您的备份方案。SAP HANA备份方案的优劣势如表1所示。 表1 SAP HANA备份方案比较 特点 基于文件的备份 基于Backint的备份 基于存储快照的备份 优势 支持备份的完整性校验 支持加密 支持备份的完整性校验 第三方备份软件支持额外的特性（如重删、压缩） 备份后立即可用于恢复 备份及恢复速度快 对业务网络无影响 支持加密 劣势 对业务网络有影响 需要额外的存储空间 需要对文件系统监控 需要更多的时间使备份可用 对业务网络有影响 没有块级别的完整性检查 父主题： SAP HANA备份与恢复方案

Storage Accelerator 客户端计算机将数据备份到 云存储 时，软件将通过MediaAgent路由数据。因此，客户端计算机首先将数据发送给MediaAgent，然后MediaAgent将数据发送给云存储库。使用客户端存储加速器“Storage Accelerator”可以加快备份过程，直接将数据发送到配置的云存储库，具体如图5所示。 对于运行在云中的SAP HANA系统，这是一个非常有用的特性。对于大型单节点HANA系统，它允许从集中的介质管理服务器分流数据流，对于多节点HANA系统，随着节点数量的增加，它提供接近线性的可伸缩性。 图5 Storage Accelerator备份流程

重复数据删除管理 随着HANA数据快速增长，以及企业要求备份和恢复的时间点越来越多，保存数据的成本也变得越来越严重。研究发现，SAP HANA备份数据中的数据中高达60%是冗余的，重复率很高，随着时间的推移，重复数据越来越多。为了缓解存储系统的空间增长问题，缩减数据占用空间、降低成本，最大程度地利用已有资源，重复数据删除已成为存储领域一个热门的技术。一方面，利用重复数据删除技术可以对存储空间的利用率进行优化，消除分布在存储系统中的相同文件或者数据块。另一方面，利用重复数据删除技术可以减少在网络中传输的数据量，进而降低能量消耗和网络成本，并为数据复制大量节省网络带宽。 Commvault将源端和目标端重复数据删除功能完全集成到统一数据管理平台中，在将备份数据通过网络发送到服务器和存储器之前，先在源端进行重复数据删除，以消除冗余的数据。Commvault重复数据删除，实现了更短的备份窗口、更低网络带宽占用、更低的存储成本以及更可靠的数据保护。 Commvault采用基于数据块级别的重复数据删除技术，利用SHA 512 (Secure Hash Algorithm)算法来比对数据块是否重复，SHA512是目前为止最为安全的散列算法。Commvault具有内容感知功能，智能切割备份/归档数据块，快速识别备份/归档数据中的相同数据块，并确保相同数据块在存储设备上只保留一次。 Commvault去重主要由MediaAgent来负责管理，MediaAgent管理3个部分： 去重数据库 去重数据用来比对数据块的哈希值，去重数据库的性能，会影响重复数据删除的性能。建议采用高IO磁盘存储，例如：华为云中的超高IO云硬盘。 备份/归档索引 记录数据块的逻辑与物理位置信息，通过索引，可以知道一个数据文件由那些数据块所组成，要利用索引来进行数据恢复，数据恢复并不需要访问去重数据库。建议采用高IO磁盘存储，例如：华为云中的超高IO云硬盘。 去重数据存储空间 用于存放去重的物理数据块，通常是大容量的通用磁盘存储，可以是云存储、DAS、SAN或NAS磁盘存储设备。云中建议采用S3存储，如：华为云中的 对象存储服务 OBS。 Commvault的DDB数据库是MemDB（主存数据库）。MemDB能提供更高的性能，但MemDB最好存放在SSD磁盘上或其他高速磁盘上。一个DDB数据库，可根据用户的环境，选择不同的配置，具体如表3所示。 表3 DDB数据库配置 规模 前端容量 DDB数据库 后端容量 并发流数 Xsmall 5 TB~15 TB 200 GB 25 TB 25 Small 10 TB~30 TB 400 GB 50 TB 50 Medium 30 TB~60 TB 600 GB 75 TB 100 Large 60 TB~125 TB 1.2 TB 150 TB 200 Xlarge 110 TB~150 TB 2 TB 250 TB 300

多副本管理 利用Commvault平台能轻松实现多副本管理，比如做D2C2C备份，或D2C2T备份。把备份副本复制到云存储或本地数据中心的磁带库上。 Aux Copy（辅助拷贝）是备份数据的复制操作，把数据从一个副本复制到另外一个副本，用于创建多副本或DR（灾难恢复）备份。 图6 多副本复制 辅助拷贝可实现不同介质之间的数据复制，去重副本的辅助拷贝，称为DASH Copy，仅复制新的数据块。存储策略中含三种类型副本： Primary 主副本，备份操作时，数据先只能写入主副本。 Synchronous 同步副本，利用AuxCopy产生的次级副本，数据内容与主副本完全相同。 Selective 选择副本，利用AuxCopy产生的次级副本，数据内容只选择全备份数据。

如何保护SAP HANA数据库 SAP HANA是内存数据库，数据库运行时，数据都放在内存中，如何备份HANA数据库呢？为了更好理解HANA数据库的备份原理，首先我们分析下HANA数据保护机制。大家都知道当服务器断电时，放在内存里的数据就会全丢失，为了避免这类内存故障，HANA数据库会定时把数据存储到持久性存储（磁盘）上，主要有以下两个机制： 保护点（Savepoint） HANA数据库定时会发起保护点操作，默认是5分钟进行一次，保护点操作会把数据库中的数据及Undo信息一起写入到磁盘上，Undo信息中包含了未提交的事务。HANA系统能从保护点进行完全恢复。 重做日志（Redo） 数据库的事务也会记录在内存中的Redo日志缓存中，默认Redo缓存为1MB，当事务被提交或当日志缓存写满时，HANA数据库会把缓存中的Redo日志写到磁盘上。利用Redo日志，可以把HANA数据库恢复到保护点后的某一个时间点。 利用持久性存储，HANA可以防止任何内存故障，但一旦持久性存储发生故障，HANA数据仍然会被破坏而无法恢复。需要利用备份来保护持久性存储上的数据，把持久性存储上的数据备份到外部存储上，这样才能达到数据保护目的。在数据备份时先会触发一个保存点（Savepoint），确保持久性存储上的数据具有数据库一致的映像，确保数据库可恢复。目前，SAP数据备份支持在线全备份、增量备份、差量备份。备份过程不具备中断再续的能力，如果备份过程中发生错误，整个数据库备份将从头再来。 持久性存储上的Redo日志也需要备份到外部存储上，如果持久性存储上的日志不备份，日志是不能被删除的，大量的日志会把日志存储区填满，导致数据库被锁起来。图2是数据备份和日志备份的示意图。 图2 数据备份和日志备份示意图

SAP HANA备份架构 图1 SAP HANA备份架构图 图1是一个典型的SAP HANA多节点备份拓扑架构图，在HANA节点服务器上安装Commvault的SAP HANA备份代理模块iDA for SAP HANA，Commvault的备份管理服务器CS管理备份策略和调度备份计划，介质代理服务器MA负责连接OBS对象存储，并将备份数据去重后写入到OBS对象存储中。 对于数据量较大的HANA，Commvault提供了“Storage Accelerator”存储加速功能，可提升备份和恢复性能。 Commvault备份软件的组件如下： 管理服务器（CommServe，即上图中CS） CommServe集中管理CommCell中所有软件组件，协调并执行CommCell中所有操作，CommServe包含一个Microsoft SQL Server数据库，用来记录所有的配置信息、安全属性以及操作历史以及Metadata。在一个CommCell中，只能有一个CommServe，CommServe可以安装在物理服务器、虚拟服务器或集群环境中。 华为云中的云服务器推荐如表1所示。 表1 推荐的云服务器 规模 客户端数量 服务器配置 云服务器规格 Small 25 servers, or 100 virtual machines 4 CPU cores, 16 GB RAM c6.xlarge.4 Medium 500 servers, or 1000 virtual machines 8 CPU cores, 32 GB RAM c6.2xlarge.4 Large 2500 servers, or 5000 virtual machines 12 CPU cores, 64 GB RAM c6.4xlarge.4 Xlarge 10,000 servers, or 20,000 virtual machines 16 CPU cores, 128 GB RAM m3.4xlarge.8 介质代理（MediaAgent，即上图中MA） MediaAgent在CommCell中负责管理数据传输，管理数据存储的介质库：磁盘库、磁带库、云存储等。CommServe指挥并协调MediaAgent执行任务，在一个CommCell中可以部署多台MediaAgent来拓展性能，MediaAgent可以安装在物理服务器、虚拟服务器或集群环境中，能支持Window、Linux和Unix操作系统。 华为云中的云服务器推荐如表2所示。 表2 推荐的云服务器 规模 客户端数量 服务器配置 后端容量 云服务器规格 Xsmall 5 TB~15 TB 2 CPU cores, 16 GB RAM 25 TB m6.large.8 Small 10 TB~30 TB 4 CPU cores, 24 GB RAM 50 TB m6.xlarge.8 Medium 30 TB~60 TB 8 CPU cores, 32 GB RAM 75 TB c6.2xlarge.4 Large 60 TB~125 TB 12 CPU cores, 64 GB RAM 150 TB c6.4xlarge.4 Xlarge 110 TB~150 TB 16 CPU cores, 128 GB RAM 250 TB m6.4xlarge.8 客户端（Client，即上图中iDA） 被保护及被管理的生产服务器称为客户端，通常会在客户端上安装软件代理模块，或为客户端配置一个代理服务器上软件代理模块，来实现数据保护、管理及传输。

SAP HANA数据库备份及恢复策略 对SAP HANA数据库可以进行全备份、增量备份、差量备份和日志备份。备份策略可按图3进行编排。 图3 备份策略 全备份 全备份是备份数据库数据卷上的所有数据，一般放在周末进行，对系统影响比较小。 增量备份 增量备份收集了上次任何备份后的数据，在一天当中可以进行多次增量备份，比如可以在早上、中午、晚上结算前进行增量备份。 差量备份 差量备份收集了上次全备份后的变化数据，一般在每天晚上结算后进行。 日志备份 对数据卷的备份可以是手动或按备份计划进行，而日志的备份都是自动进行的，默认情况下，每15分钟做一次日志备份，当然备份的频率是可根据用户的需求进行调整的。 日志备份非常重要，如果持久性存储上的日志不备份，日志是不能被删除的，大量的日志会把日志存储区填满，导致数据库被锁起来。 Commvault在SP16以后默认情况下，SAP HANA代理将所有数据库服务中的日志文件备份为每6小时一次持久日志备份作业。可以集中持续的将所有服务的日志统一备份，减少备份作业的数量。 可以利用备份，把SAP HANA数据库恢复到某一个时间点，恢复的次序是： 恢复最后全备份。 恢复最后差量备份。 恢复接下来的所有增量备份。 恢复接下来的日志备份。 恢复到最新：如果Log区中的日志没有丢失，数据将没有损失。 恢复到指定的时间点：逻辑错误会导致最新数据是不正确的，因此需要恢复到以前某一个时间点。 在图4中，恢复一个全备份，最近的差量备份（D3）和最新的一个增量备份（I4），再进行一个日志前滚操作，就能完成数据的最新恢复。 图4 数据恢复

概述 一个典型的SAP HANA单节点的文件系统示例如表1所示： 表1 SAP HANA文件系统 文件系统 推荐的文件系统类型 使用的华为云云服务 用途 / ext4 云硬盘 OS卷 /usr/sap xfs 云硬盘 SAP系统目录 /hana/log xfs 云硬盘 HANA Log卷 /hana/data xfs 云硬盘 HANA Data卷 /hana/shared xfs 云硬盘 HANA Shared卷 /hana/backup nfs 弹性文件服务 HANA备份文件存放目录，后续简称Backup目录 根据SAP官方文档《SAP HANA管理员指南》中的描述，SAP HANA支持如下备份与恢复的功能： 全量备份 Data文件备份 Data卷快照 Delta备份 增量备份 差异备份 Redo log备份 使用第三方软件的备份与恢复 备份完整性检查 备份生命周期管理 指定时间点的恢复（PITR） 指定Data卷文件备份或Data卷快照的恢复（不使用Log卷备份） 使用备份与恢复拷贝新数据库 以上备份功能，按照备份方式，可分为以下三类： 基于文件的备份 基于存储快照的备份 基于Backint接口的第三方软件的备份 不同场景所需要的备份数据如表2所示： 表2 不同场景的备份数据 场景 所需要的备份数据 恢复SAP HANA到最近的状态 最近的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份 Log区数据 恢复SAP HANA到指定时间点（PITR） 最近的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份（包括此时间点之后的日志备份） Log区数据 恢复SAP HANA到指定数据备份或者存储快照 指定的数据备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） 恢复SAP HANA到某个Log位置 Log位置之前的Data备份（基于文件的备份、基于存储快照的备份或基于Backint的备份） Data备份后的Log备份 Log区数据 父主题： SAP HANA备份与恢复方案

备份策略示例 操作系统的备份策略示例 灾难发生时，为了快速还原系统，省去SAP应用的安装及OS层的配置工作，以达到客户所需要的RTO， 一般建议每个系统都要做操作系统层面的备份，建议开发测试系统每半年或当系统有升级或其他重大调整前后备份一次，至少保留一份，生产系统系统每季度或当系统有升级或其他重大调整前后备份一次，至少保留二份。操作系统的备份策略示例如表1所示。 表1 操作系统的备份策略示例 备份对象 备份内容 备份频率 保留周期 备注 开发系统应用&数据库 操作系统 （包括/etc，/home等） 每6个月备份1次 1年 每次系统有升级或其他重大调整前需备份一次 测试系统应用&数据库 每6个月备份1次 1年 生产系统应用&数据库 每3个月备份1次 1年 重要文件系统的备份策略示例 灾难发生时，为了快速还原系统，除了操作系统的定期备份，您还需要对操作系统变更频繁的重要文件系统目录备份，比如传输目录/usr/sap/trans、 /sapmnt或者客户自定义的其它目录。重要文件系统的备份策略示例如表2所示。 表2 重要文件系统的备份策略示例 备份对象 备份内容 备份频率 保留周期 开发系统应用 /sapmnt，/usr/sap，/etc，/home以及其它目录 每周备份1次 2周 测试系统应用 每周备份1次 2周 生产系统应用 每周备份2次 1月 父主题： SAP应用备份与恢复方案

概述 本文档主要介绍如何在华为云上进行SAP系统的备份与恢复，重点描述华为云上备份与恢复方案中特殊的部分，本文档不可替代SAP或各数据库的官方文档。 本文档中涉及SAP软件或各数据库的约束与规格，如果出现与官方文档冲突时，请以官方文档为准。 本文档假定您已经熟悉在华为云上进行SAP系统的部署与操作。如果您初次接触华为云SAP解决方案，建议您在阅读本文档前，先阅读以下文档： SAP部署指南 SAP HANA用户指南（单节点） SAP NetWeaver用户指南 您也可以通过访问SAP官网阅读华为云相关的SAP说明，具体如表1所示。 表1 华为云相关SAP Notes SAP Note # 标题 2582296 SAP Applications on Huawei Cloud: Supported Products and Huawei Cloud VM types 2582305 SAP on Huawei Cloud: Support prerequisites 2570214 Linux on Huawei Cloud: Adaption of your SAP License 2570198 SAP on Linux with Huawei Cloud: Enhanced Monitoring 2644322 SAP Adaptive Server Enterprise (ASE) 16.0 Certification Report for Huawei Cloud

URI GET /v1/{project_id}/tags/value 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String project_id 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 参数解释： 标签类型，分为用户标签及用户组标签。 约束限制： 不涉及 取值范围： 以下枚举值： user：用户类型标签； userGroup：用户组类型标签。 默认取值： 不涉及 offset 否 Integer 返回条目的起始offset，默认值0。 limit 否 Integer 返回条目数，默认值10。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Workspace-Id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 X-Auth-Token 是 String 用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 导出包名称。 export_param 否 ResourcePackageExportParam object 导出高级参数。 resources 是 Array of objects 导出资源明细。 表4 ResourcePackageExportParam 参数 是否必选 参数类型 描述 export_dataset_tag_permission 否 Boolean 是否携带数据集行权限-标签授权。 表5 resources 参数 是否必选 参数类型 描述 resource_type 是 String 参数解释： 资源类型枚举值，用于指定授权对象的类型。 示例：datasource，指定授权对象类型为数据源。 约束限制： 不涉及 取值范围： 以下枚举值： datasource：数据源； dataset：数据集； metric：指标； dashboard：仪表板； screen：大屏； embedAnalysis：嵌入分析； portal：数据门户； subject：智能分析助手。 默认取值： 不涉及 resource_id 是 String 资源ID。