SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场azure-mgmt-arizeaiobservabilityeval-dotnet

azure-mgmt-arizeaiobservabilityeval-dotnet

部署与运维

查看项目

更新于 10-16 11:33

技能介绍

用途

Azure.ResourceManager.ArizeAIObservabilityEval 是面向 .NET 的 Azure Resource Manager SDK，用于在 Azure 上管理 Arize AI Observability and Evaluation 资源。其管理的 ARM 资源类型为 ArizeAi.ObservabilityEval/organizations，适合通过代码方式在 Azure 订阅中管理 Arize AI 组织，并通过 Azure Marketplace 完成相关订阅。

主要能力

该 SDK 支持以下操作：

  • 创建 Arize AI 组织（通过 Azure Marketplace 订阅信息与用户联系信息）
  • 获取单个组织（支持直接获取、先判断是否存在、GetIfExists 返回空值三种方式）
  • 在资源组或订阅范围内列出组织
  • 更新组织（如更新标签）
  • 删除组织
  • 通过资源标识符直接访问资源，无需先列出

包信息

  • 包名：Azure.ResourceManager.ArizeAIObservabilityEval
  • 版本：1.0.0（GA）
  • API 版本：2024-10-01
  • ARM 类型：ArizeAi.ObservabilityEval/organizations
  • 依赖：Azure.Core >= 1.46.2，Azure.ResourceManager >= 1.13.1

安装

dotnet add package Azure.ResourceManager.ArizeAIObservabilityEval --version 1.0.0

环境变量

  • AZURE_SUBSCRIPTION_ID：Azure 订阅 ID（必填）
  • AZURE_TOKEN_CREDENTIALS：仅当在生产中使用 DefaultAzureCredential 时必填，可设为 prod 或指定凭据
  • AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET：用于服务主体认证（可选）

使用方式

认证

可使用 DefaultAzureCredential，或在生产中直接使用特定凭据；随后用凭据创建 ArmClient。文档给出了对应代码示例。

核心工作流

  1. 创建组织：构建 ArizeAIObservabilityEvalOrganizationData，包含位置、组织属性（Marketplace 详情、Offer 详情、用户详情）与标签，通过集合的 CreateOrUpdateAsync 执行（长时运行操作，使用 WaitUntil.Completed）。
  2. 获取组织：可从集合 GetAsync、先 ExistsAsync 再获取，或用 GetIfExistsAsync 返回空值判断。
  3. 列出组织：可在资源组内或订阅范围内遍历。
  4. 更新组织：通过 ArizeAIObservabilityEvalOrganizationPatch 更新标签等。
  5. 删除组织：调用 DeleteAsync(WaitUntil.Completed)。
  6. 直接访问：使用 CreateResourceIdentifier 构建资源标识符后获取资源。

主要类型

  • ArizeAIObservabilityEvalOrganizationResource：Arize 组织的主 ARM 资源
  • ArizeAIObservabilityEvalOrganizationCollection：用于 CRUD 操作的集合
  • ArizeAIObservabilityEvalOrganizationData：资源数据模型
  • ArizeAIObservabilityEvalOrganizationProperties：组织属性
  • ArizeAIObservabilityEvalMarketplaceDetails：Azure Marketplace 订阅信息
  • ArizeAIObservabilityEvalOfferDetails：Marketplace Offer 配置
  • ArizeAIObservabilityEvalUserDetails：用户联系信息
  • ArizeAIObservabilityEvalOrganizationPatch：更新用的补丁模型
  • ArizeAIObservabilityEvalSingleSignOnPropertiesV2：SSO 配置

枚举

  • ArizeAIObservabilityEvalOfferProvisioningState：Succeeded、Failed、Canceled、Provisioning、Updating、Deleting、Accepted
  • ArizeAIObservabilityEvalMarketplaceSubscriptionStatus：PendingFulfillmentStart、Subscribed、Suspended、Unsubscribed
  • ArizeAIObservabilityEvalSingleSignOnState：Initial、Enable、Disable
  • ArizeAIObservabilityEvalSingleSignOnType：Saml、OpenId

最佳实践

  • 使用异步方法，所有操作支持 async/await
  • 处理长时运行操作，使用 WaitUntil.Completed 或手动轮询
  • 使用 GetIfExistsAsync 避免条件逻辑抛出异常
  • 通过 ArmClientOptions 实现重试策略
  • 使用资源标识符直接访问资源而无需列出
  • 正确关闭客户端，使用 using 语句或显式释放

错误处理

可捕获 Azure.RequestFailedException，按状态码（如 404）判断组织是否存在，或输出 Azure 错误信息。

相关链接

  • NuGet 包
  • Azure SDK for .NET
  • Arize AI

限制

该资料未提供 SDK 的定价、性能表现或与其他工具对比等信息；具体功能以 SDK 与 Azure 平台实际能力为准。