凭据自动售货机 API - Amazon Lake Formation
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

凭据自动售货机 API

凭据自动售货机 API 描述了与使用Amazon Lake Formation服务来发送凭据以及注册和管理数据湖资源。

数据类型

筛选条件结构

此结构描述了基于筛选条件筛选表中的列的过滤。

字段

  • Field – UTF-8 字符串(有效值:RESOURCE_ARN | ROLE_ARN | LAST_MODIFIED)。

    要在筛选条件下过滤的字段。

  • ComparisonOperator— UTF-8 字符串(有效值:EQ|NE|LE|LT|GE|GT|CONTAINS|NOT_CONTAINS|BEGINS_WITH|IN|BETWEEN)。

    在筛选条件中使用的比较运算符。

  • StringValueList – UTF-8 字符串数组。

    一个字符串,其中包含用于评估筛选条件的值。

ColumnNames

表中的列名的列表。

UTF-8 字符串数组。

表中的列名的列表。

Resource Info 结构

包含有关Amazon Lake Formation资源。

字段

  • ResourceArn – UTF-8 字符串。

    资源的 Amazon 资源名称 (ARN)。

  • RoleArn – UTF-8 字符串,与 Custom string pattern #5 匹配。

    这些区域有:IAM注册资源的角色。

  • LastModified – 时间戳。

    上次修改资源的日期和时间。

操作

RegistRegerResource 操作(Python:register _resource)

将资源注册为由数据目录管理。

要添加或更新数据,Amazon Lake Formation需要对选定的读/写访问权限Amazon S3路径。选择您知道有权执行此操作的角色,或者选择 AWSServiceRoleForLakeFormationDataAccess 服务相关角色。当你注册第一个Amazon S3路径、服务相关角色和新的内联策略将代表您创建。Lake Formation将第一个路径添加到内联策略并将其附加到服务相关角色。当你注册后续路径时,Lake Formation将路径添加到现有策略。

以下请求注册了一个新的位置并给出Lake Formation允许使用服务相关角色访问该位置。

ResourceArn = arn:aws:s3:::my-bucket UseServiceLinkedRole = true

如果UseServiceLinkedRole未设为 true,您必须提供或设置RoleArn

arn:aws:iam::12345:role/my-data-access-role

请求

  • ResourceArn:必需 UTF-8 字符串。

    您要注册的资源的 Amazon 资源名称 (ARN)。

  • UseServiceLinkedRole – 布尔值。

    指定Amazon Identity and Access Management(IAM) 通过向数据目录注册此角色来实现与服务相关的角色。服务相关角色是一种与 Lake Formation 直接关联的独特类型的 IAM 角色。

    有关更多信息,请参阅为 Lake Formation 使用服务相关角色

  • RoleArn – UTF-8 字符串,与 Custom string pattern #5 匹配。

    注册资源的角色的标识符。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • AlreadyExistsException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • AccessDeniedException

取消注册资源操作(Python:deRegister_resource)

取消注册由数据目录管理的资源。

当你取消注册路径时,Lake Formation从附加到服务相关角色的内联策略中删除路径。

请求

  • ResourceArn:必需 UTF-8 字符串。

    您要取消注册的资源的 Amazon 资源名称 (ARN)。

响应

  • 无响应参数。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException

ListResource 操作(Python:list_resource)

列出注册由数据目录管理的资源。

请求

  • FilterConditionList— 数组筛选条件对象,不少于 1 个或不超过 20 个结构。

    资源的任何适用的行级和/或列级筛选条件。

  • MaxResults – 数字(整数),不小于 1 或大于 1000。

    资源结果的最大数量。

  • NextToken – UTF-8 字符串。

    延续标记 (如果这不是检索这些资源的第一个调用)。

响应

  • ResourceInfoList资源信息 对象的数组。

    数据湖资源的摘要。

  • NextToken – UTF-8 字符串。

    延续标记 (如果这不是检索这些资源的第一个调用)。

错误

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException