The GA version of Binary Authorization provides an updated REST API and gcloud
command set. Update any scripts or automations that access these interfaces as
follows:
REST API
Use GA REST API endpoints relative to the following URL
https://binaryauthorization.googleapis.com/v1/ instead of
https://binaryauthorization.googleapis.com/v1beta1.
When you create a new attestor when calling the
GA version of the REST API, you send a JSON message that describes the
attestor as part of the request. In the Beta version of the API, the JSON
message contained a field named UserOwnedDrydockNote. In the GA version,
the name of this field is UserOwnedGrafeasNote.
Google Cloud CLI
Use GA gcloud commands in gcloud container binauthz
instead of gcloud beta container binauthz.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe Binary Authorization Beta API was discontinued on September 16, 2019, and will cease to function after March 16, 2020, requiring migration to the GA version.\u003c/p\u003e\n"],["\u003cp\u003eUsers of the Binary Authorization Beta API must migrate to the GA version to avoid service interruption, while no action is required for those not using the Beta version.\u003c/p\u003e\n"],["\u003cp\u003eMigration to the GA version involves updating scripts and automations to use the GA REST API endpoints (\u003ccode\u003ehttps://binaryauthorization.googleapis.com/v1/\u003c/code\u003e) and the GA \u003ccode\u003egcloud\u003c/code\u003e command set (\u003ccode\u003egcloud container binauthz\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe GA version of the REST API uses \u003ccode\u003eUserOwnedGrafeasNote\u003c/code\u003e in JSON messages for creating attestors, replacing the Beta version's \u003ccode\u003eUserOwnedDrydockNote\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArtifact Analysis Beta API users are recommended to start using the generally available version of the API instead.\u003c/p\u003e\n"]]],[],null,["# GA migration guide\n\n| **Note:** **Binary Authorization Beta API users:** Support for the Binary Authorization Beta API was discontinued on September 16, 2019. As a result, **the Binary Authorization Beta API will stop\n| working after March 16, 2020. To prevent service interruption, you must take\n| actions outlined in this page to migrate to the GA version.**\n\nIf you do not have workloads that use the Binary Authorization Beta version, no\naction is required on your part.\n| **Note:** **Artifact Analysis Beta API users:** Use the GA version of the [Artifact Analysis API](/artifact-analysis/docs/reference/rest).\n\n[Binary Authorization is now generally available](/binary-authorization/docs/release-notes#September_16_2019).\nIf your workloads use the Binary Authorization Beta API, perform the following\nsteps to migrate to the GA version.\n\nMigration steps\n---------------\n\nThe GA version of Binary Authorization provides an updated REST API and `gcloud`\ncommand set. Update any scripts or automations that access these interfaces as\nfollows:\n\n- **REST API**\n\n Use GA REST API endpoints relative to the following URL\n `https://binaryauthorization.googleapis.com/v1/` instead of\n `https://binaryauthorization.googleapis.com/v1beta1`.\n\n When you [create a new attestor](/binary-authorization/docs/creating-attestors-rest) when calling the\n GA version of the REST API, you send a JSON message that describes the\n attestor as part of the request. In the Beta version of the API, the JSON\n message contained a field named `UserOwnedDrydockNote`. In the GA version,\n the name of this field is `UserOwnedGrafeasNote`.\n- **Google Cloud CLI**\n\n Use GA `gcloud` commands in `gcloud container binauthz`\n instead of `gcloud beta container binauthz`."]]
