Device Run API . projects . locations . softwareVersions

close()

Close httplib2 connections.

get(name, x__xgafv=None)

Returns information about a specific software version.

Args:
  name: string, Required. The name of the software version. Format: `projects/{project}/locations/global/softwareVersions/{software_version}`. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A single software version in the catalog.
  "androidxTestOrchestratorDetails": { # AndroidX Test Orchestrator-specific attributes. Reserved for future orchestrator-only fields. # Output only. Contains AndroidX Test Orchestrator-specific attributes (set when software_type == ANDROIDX_TEST_ORCHESTRATOR).
  },
  "displayName": "A String", # Output only. Provides a human-readable name for this version, e.g. "AndroidX Test Orchestrator 1.4.1".
  "isDefault": True or False, # Output only. Indicates whether the system uses this version when a request does not select one explicitly. Exactly one version per `software_type` is the default, and it may change over time.
  "lifecycle": { # Catalog resource lifecycle: maturity state plus key lifecycle dates. # Output only. The version lifecycle (maturity stage and removal date).
    "removalDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. Specifies the date the resource is scheduled to be removed from the catalog. Only set when `state == DEPRECATED`.
      "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
      "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
    },
    "state": "A String", # Output only. Specifies the current maturity state of the resource.
  },
  "name": "A String", # Identifier. Identifies the software version resource. Format: `projects/{project}/locations/{location}/softwareVersions/{software_version}`. The {software_version} segment is an opaque, stable string. Clients must not parse it to derive or assume the version.
  "softwareType": "A String", # Output only. Specifies which software this is a version of. Filter on this field to narrow the collection to a single kind of software, for example `software_type = "ANDROIDX_TEST_ORCHESTRATOR"`.
  "version": "A String", # Output only. Specifies the version identifier, e.g. "1.4.1". Unique within a `software_type`.
  "xcodeDetails": { # Xcode-specific attributes. # Output only. Contains Xcode-specific attributes (set when software_type == XCODE).
    "supportedIosVersions": [ # Output only. Lists the iOS versions this Xcode can run tests against, e.g. "16.6". This is a property of the toolchain, so it says nothing about whether a device on that iOS version is available; list the `Device` collection to find out.
      "A String",
    ],
  },
}

list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists all software versions.

Args:
  parent: string, Required. The parent of the collection of software versions. Format: `projects/{project}/locations/global`. (required)
  filter: string, Optional. An AIP-160 (https://google.aip.dev/160) filter expression restricting which software versions are returned. An empty filter returns all software versions. Filtering is supported over the `SoftwareVersion` fields, including nested fields via dot-path. Enum and string values must be double-quoted. Examples: * `software_type = "ANDROIDX_TEST_ORCHESTRATOR"` * `software_type = "ANDROIDX_TEST_ORCHESTRATOR" AND is_default = true` * `lifecycle.state = "ACTIVE"` * `version = "1.4.1"`
  pageSize: integer, Optional. The maximum number of software versions to return. The server may return fewer items than this value.
  pageToken: string, Optional. A page token, received from a previous `ListSoftwareVersions` call. Provide this to receive the subsequent page. When paginating, all other parameters provided to `ListSoftwareVersions` must match the call that provided the page token.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response including listed software versions.
  "nextPageToken": "A String", # Token to receive the next page of software versions. This will be absent if the end of the response list has been reached.
  "softwareVersions": [ # The list of software versions.
    { # A single software version in the catalog.
      "androidxTestOrchestratorDetails": { # AndroidX Test Orchestrator-specific attributes. Reserved for future orchestrator-only fields. # Output only. Contains AndroidX Test Orchestrator-specific attributes (set when software_type == ANDROIDX_TEST_ORCHESTRATOR).
      },
      "displayName": "A String", # Output only. Provides a human-readable name for this version, e.g. "AndroidX Test Orchestrator 1.4.1".
      "isDefault": True or False, # Output only. Indicates whether the system uses this version when a request does not select one explicitly. Exactly one version per `software_type` is the default, and it may change over time.
      "lifecycle": { # Catalog resource lifecycle: maturity state plus key lifecycle dates. # Output only. The version lifecycle (maturity stage and removal date).
        "removalDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. Specifies the date the resource is scheduled to be removed from the catalog. Only set when `state == DEPRECATED`.
          "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
          "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
          "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        },
        "state": "A String", # Output only. Specifies the current maturity state of the resource.
      },
      "name": "A String", # Identifier. Identifies the software version resource. Format: `projects/{project}/locations/{location}/softwareVersions/{software_version}`. The {software_version} segment is an opaque, stable string. Clients must not parse it to derive or assume the version.
      "softwareType": "A String", # Output only. Specifies which software this is a version of. Filter on this field to narrow the collection to a single kind of software, for example `software_type = "ANDROIDX_TEST_ORCHESTRATOR"`.
      "version": "A String", # Output only. Specifies the version identifier, e.g. "1.4.1". Unique within a `software_type`.
      "xcodeDetails": { # Xcode-specific attributes. # Output only. Contains Xcode-specific attributes (set when software_type == XCODE).
        "supportedIosVersions": [ # Output only. Lists the iOS versions this Xcode can run tests against, e.g. "16.6". This is a property of the toolchain, so it says nothing about whether a device on that iOS version is available; list the `Device` collection to find out.
          "A String",
        ],
      },
    },
  ],
}

list_next(previous_request, previous_response)

Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call 'execute()' on to request the next
  page. Returns None if there are no more items in the collection.