OCI

Delete Reference

Delete an OCIReference

An OCIReference represents a relationship between an OCITag and an OCIArtifact.

When attempting to match a customer’s container image to a known OCIArtifact, we look up an OCITag that matches a particular digest. For mutable OCITags, that digest association, however, changes over time. Until OCIReference was introduced, we were only storing the first known digest for these mutable tags, which ended up introducing a lot of stale data into the digest classification process: the classifiers were not able to find OCITags that match newer digests for these mutable tags and therefore less accurate classifiers like ruleset and deduction classifier needed to try and classify the cluster inventory record.

For OCITags that are mutable — e.g. “latest” or “stable” or “v1” — there can be many digests that an OCITag has previously pointed to. Previously-referred digests for an OCITag are made available through the OCIReference object model. You may be wondering why we don’t have an References field on OCITag that just returns the digests that have been previously associated with this OCITag. The reason for that is because the list of previously-known digest associations can be very long (it’s unbounded) and so having this information in a separately-fetched object model that can be paginated/controlled seemed like a better design.

DELETE

ocireferences

{reference}

Delete Reference

curl --request DELETE \
  --url https://api.example.com/ocireferences/{reference}/

import requests

url = "https://api.example.com/ocireferences/{reference}/"

response = requests.delete(url)

print(response.text)

const options = {method: 'DELETE'};

fetch('https://api.example.com/ocireferences/{reference}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/ocireferences/{reference}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/ocireferences/{reference}/"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.example.com/ocireferences/{reference}/")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/ocireferences/{reference}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "$schema": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Response

No Content

List RepositoriesList multiple OCIRepositories An OCIRepository represents a single namespace within an OCI Registry. OCIRepositories are uniquely identified by a URI-like string where the final path of the URI represents the OCIRepository Namespace and the part of the URI before the Namespace is the Registry identifier. Examples of OCIRepository identifiers: * docker.io/istio/pilot: The pilot namespace in the docker.io/istio registry. * public.ecr.aws/bottlerocket/bottlerocket-operator<//b>: The bottlerocket-operator namespace in the public.ecr.aws/bottlerocket registry.

⌘I

Delete Reference

curl --request DELETE \
  --url https://api.example.com/ocireferences/{reference}/

import requests

url = "https://api.example.com/ocireferences/{reference}/"

response = requests.delete(url)

print(response.text)

const options = {method: 'DELETE'};

fetch('https://api.example.com/ocireferences/{reference}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/ocireferences/{reference}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/ocireferences/{reference}/"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.example.com/ocireferences/{reference}/")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/ocireferences/{reference}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "$schema": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

API Reference

Login

Risk

Account

KubeCluster

KubePlatform

OCI

Organization

Package

Project

Delete Reference

Response